大家好，我是卡卡。前两天我写了一篇关于 Hermes 的安装教程，当时我们也把消息网关配置到了飞书。说实话，当时kan着 Hermes 在飞书对话框里蹦出回复的那一刻，心里确实有点小激动。毕竟谁不想拥有一个属于自己的 J.A.R.V.I.S. 呢？

但是冷静下来用了几天我发现了一个挺尴尬的问题：虽然 Hermes Yi经Neng在飞书里聊起来了但Ru果后面还想让它继续去读文档、查表格、碰日程这些东西，那飞书 CLI 这一层还是得补上。也就是说现在打通的geng多还是聊天这一步，距离真正让 Hermes 帮我们把事情接过去，其实还差得hen远。

这就好比你雇了一个绝顶聪明的顾问，他脑子里的知识比谁dou多，Neng口若悬河地给你出谋划策，但他没有手，也没有钥匙。你想让他帮你把会议室订了或者把刚才讨论的草稿整理成文档发出去，他只Neng站在旁边告诉你：“你应该点那个按钮，然后选那个时间。”Zui后还得你自己动手去点。

这哪里是提效啊，这简直是多了一个“监工”。所以今天这篇文章，我们就来聊聊怎么把 Hermes 的“手”给它装上——也就是如何通过飞书 CLI，真正打通 Hermes 与飞书生态的任督二脉。

为什么光连上飞书还不够？

我们先得搞清楚一个概念：连接不等于控制。

当我们把 Hermes 接入飞书开放平台，配置好 App ID 和 Secret，甚至设置了事件回调，我们Zuo的其实只是建立了一个“消息通道”。Hermes Neng听到我们在说什么也Neng把话说回来。这解决了“沟通”的问题，但没有解决“执行”的问题。

比如我现在想写一篇文章，Hermes 可NengNeng先帮我们把内容整理出来甚至草稿dou写好了但它并不Neng直接帮我们在飞书里把文档建好，再把内容写进去。再比如我想发一条消息、查一下日程、建一个表格，或者搜一份知识库内容，hen多时候Zui后也还是得我们自己回到飞书里面一点一点去操作。

毕竟 AI 模型douhen聪明，但聪明不等于有用。Ru果它不知道我们现在在Zuo什么不知道我们手上有哪些文档、表格、消息、日程，也不知道我们真正想让它替我们Zuo什么那它hen多时候就还是只Neng给建议。kan起来回答得hen厉害，但Zui后真正去点、去建、去发、去操作的人，还是我们自己。

飞书 CLI 补上的，刚好就是这一层。

飞书 CLI：Agent 的“手”和“眼睛”

3月28日飞书官方命令行工具 Lark CLI v1.0.0 同步上线，基于 MIT 协议，通过命令行即可调用飞书开放平台 2500+ API，覆盖消息、日历、文档、多维表……这不仅仅是一个给开发者用的工具箱，对于 AI Agent 来说这简直是量身定Zuo的“义肢”。

应用权限解决的，geng多还是Neng不Neng接进去的问题，但飞书 CLI 补的，是geng适合 Agent 去调用的一层Neng力。它不是把现有 API 简单换成命令行，而是专门按 AI Agent 的使用方式去设计的。

它主要带来了两个维度的提升：

一层是 Context。也就是让 Hermes 不只是停留在聊天入口，而是真的Neng读到飞书里的消息、文档、表格、知识库、日历、任务这些工作上下文。它一边给了 Agent 足够多的工作上下文，让它不再是一个只会泛泛回答的模型。

另一层是 Action。也就是它不只是Nengkan，还Neng真的去创建文档、发消息、查日程、搜知识库、处理表格，把原来还要我们自己手动去点的那些事情继续往前推。另一边也真的把操作飞书这件事交到了 Agent 手里。

所以它解决的Yi经不只是 Hermes Neng不Neng连上飞书，而是连上之后它Neng不Nenggeng稳定、geng自然地把事情继续Zuo下去。

动手实战：接入飞书 CLI

前面说了这么多，接下来我们就直接开始动手，把飞书 CLI 真正接入 Hermes。这一步其实不复杂，但有几个细节特别容易踩坑，大家跟着我一步步来。

第一步：安装飞书 CLI

Ru果我们前面Yi经把 Hermes 跑起来了那Zui省事的方式其实就是直接让 Hermes 自己去装飞书 CLI。我们Ke以直接把飞书 CLI 的仓库地址丢给它，让它帮你安装：

请帮我安装飞书CLI：https://github.com/larksuite/cli

当然为了稳妥起见，或者Ru果你喜欢掌控全局的感觉，我们也Ke以自己在终端里装，直接手动执行：

npm install -g @larksuite/cli

这里我之前安装过所以这里就不再贴图了哈。装完之后记得在终端里敲一下 `lark-cli` 或者 `lark-cli --version`，确认一下是不是装成功了。

第二步：初始化配置

装完之后下一步就是把飞书 CLI 配好并授权起来。先执行初始化配置：

lark-cli config init --new   ## 配置应用凭证

这一步执行之后终端里一般会弹出一个二维码或者登录链接，我们直接用飞书扫一下就行。

扫完之后后面会进入 CLI 的初始化配置流程，这时候它会让我们选择是新建一个 CLI 应用，还是直接使用Yi有的应用。

因为我们前面在安装 Hermes 的时候，其实Yi经配过飞书应用了所以这里我就没有再重新建一套，而是直接选了Yi有的应用。这样Neng保证权限体系的一致性，避免后面还要去企业后台搞双重管理。

然后我们直接选择Yi有应用之后终端里提示配置成功就 ok 了cli 界面也会返回配置成功的信息。

第三步：登录授权

配置跑通之后下一步再去Zuo登录授权：

lark-cli auth login --recommend  ## 登录授权

这里顺手提一下`--recommend` 这个参数走的是推荐权限配置，所以会一次把常用权限带上。Ru果觉得权限给得太多了也Ke以不带 `--recommend`，自己按需要去选要绑定哪些权限，这样会geng灵活一点。

这一步执行之后终端里会提示我们在浏览器里打开一个认证链接，我们直接点开就行。Ru果是第一次授权，打开之后一般会kan到一个权限确认页面这时候按流程正常授权就Ke以了。

授权Zuo完之后cli 界面会返回我们授权成功的应用权限信息。我这里因为前面Yi经授权过了所以这一步走得会geng顺一点，正常授权完成就行。

我们也Ke以执行：

lark-cli auth status

来查kan账号当前Yi授予的全部权限哈。

那个容易被忽略的“白名单”坑

我这边前面把飞书 CLI 授权跑完之后去测试的时候发现其实还没有生效。后面排了一下才发现，Hermes 这里还需要补飞书用户白名单配置，不然前面的授权就算跑通了Hermes 这边也还是不认。

这一点真的特别关键，hen多教程里可Nengdou没提，导致大家配完之后发现怎么还是报错或者没反应。

我们得在 Hermes 的环境配置里加上白名单。比如Ke以在 Hermes 的 env 配置文件Zui下面加上自己的 open_id：

FEISHU_ALLOWED_USERS=ou_f072e8875039516834c5ea504bxxxx

当然Ru果你是在本地测试，或者想直接允许所有用户，也Ke以这样配：

GATEWAY_ALLOW_ALL_USERS=true

配置完之后记得重启 Hermes，不然这一步也不会生效。这一步Zuo完，才算真正把路铺平了。

验证时刻：让 Hermes 动起来

前面我们把飞书 CLI 配好之后接下来Zui好还是实际跑一下kan Hermes 是不是真的Yi经Neng用了。

Zui直接的方式，就是直接去飞书里的 Hermes 应用机器人里试一句话。比如我这里直接让它帮我创建一个测试文档，kankan它是不是Yi经有权限正常去调用飞书Neng力了：

帮我创建一个测试文档

Ru果这一步Neng正常创建出来那基本就说明前面的飞书 CLI 配置、授权，还有 Hermes 这边的链路douYi经跑通了。

我这里测试下来是Ke以正常创建的，所以到这里为止，Hermes 和飞书 CLI 这一套就算是真的接好了后面也就不是只Neng聊天了而是真的Ke以开始结合飞书去Zuo事情了。

当然创建文档只是Zui简单的一种验证方式。Ru果这一步Yi经通了后面其实还Ke以继续去Zuohen多事情。比如读取一篇飞书文档，再帮我们整理排版后发送到公众号草稿箱；比如创建一个定时任务；再比如查日程、发消息、建表格，这些douKe以顺着往下试。

从“建议者”到“执行者”的转变

当我们把这一切dou跑通之后你会发现 Hermes 的角色发生了微妙的变化。

以前geng多是我们自己去操作飞书，Agent 在旁边给建议；现在慢慢变成了 AI 去操作飞书，我们自己负责判断、负责拍板。

比如出错的时候，它不是只返回一个报错结果，而是会告诉 Agent 下一步怎么修；缺权限的时候，也不是直接卡住而是会引导补授权；包括命令本身也在尽量优化 token 消耗。这种体验上的优化，是单纯调用 API hen难Zuo到的。

虽然我们现在可Neng也还是刚开始接触 Hermes，但这类东西本来就不是一开始就完全体的，而是Ke以一步一步去补、一步一步去完善的。就像这篇里我们接入的飞书 CLI，它带来的变化其实hen直接，就是让 Hermes 不再只是停留在对话这一层了。

只要工具越来越多、权限越来越完整、场景越接越深，Hermes 就不再只是一个Neng聊天的机器人，而是会越来越接近一个真正Neng帮我们Zuo事的 Agent。

所以我觉得这件事对 Hermes 真正重要的地方，也不只是多接了一个 CLI，或者多打通了一层权限。而是从这里开始，我们后面就有了geng多往下接的空间。

飞书是字节跳动旗下 AI 工作平台，提供一站式协同办公、组织管理、业务提效工具和深入企业场景的 AI Neng力，让 AI 真Neng用、真落地。而 Hermes 作为一个强大的 Agent 框架，两者的结合潜力巨大。

Ru果你只是想玩玩，那简单的消息互通就够了。但Ru果你真的想把 AI 融入到工作流里让它替你干脏活累活，那么飞书 CLI 这一步，绝对是绕不开的关键。别嫌麻烦，配一次省下的时间以后dou数不清。

大家赶紧去试试吧，有问题咱们评论区见！

---