💡阅读指南

这一节只做一件事：让本机具备飞书 CLI，并确认它能被正常调用。读者不需要记住飞书 CLI 的命令体系。后面的文档、知识库和多维表格操作，都应该交给 Hermes 根据任务自己选择命令。

5.1 飞书不是一个单一工具

前面我们已经用过几个 CLI，比如网易云音乐 CLI、yt-dlp。它们的边界比较清楚：一个主要用来操作音乐，一个主要用来下载视频。飞书不太一样。

飞书不是一个单一工具，而是一整套办公系统。它里面有文档、云空间、知识库、多维表格、电子表格、日历、消息、审批、任务、邮箱、会议纪要、通讯录。普通用户看到的是一个界面，但对 Hermes 来说，这里面其实是一组可以被调用的能力。

CLI 把飞书开放平台里复杂的 API 封装成终端命令。Hermes 不需要自己拼 HTTP 请求，也不需要记住每个接口的路径和参数。它可以读取命令帮助，选择合适的子命令，执行以后再根据 JSON 输出判断结果。

所以，在 Agent 时代，飞书 CLI 并不是让普通用户每天手工敲命令。它更像是给 Hermes 准备的一组工具接口。

5.2 安装飞书 CLI

飞书 CLI 的命令是 lark-cli。

如果你的电脑已经安装了 Node.js，可以直接用 npm 安装：

Bash
npm install -g @larksuite/cli

安装完成后，先确认命令是否存在：

Bash
lark-cli --version

如果能看到版本号，说明飞书 CLI 已经装好。

当然，除非你是非遗程序员，否则最优的方式应该是交给 Hermes 安装：

Text
帮我在本机安装飞书 CLI，并确认 lark-cli --version 可以正常返回。
alt text

5.3 练一下：问飞书"我是谁"

CLI 装好了，执行一条命令试试：

Bash
lark-cli whoami

显示：

JSON
{
  "ok": false,
  "error": {
    "type": "config",
    "subtype": "not_configured",
    "message": "not configured",
    "hint": "run `lark-cli config init --new` in the background. It blocks and outputs a verification URL — retrieve the URL and open it in a browser to complete setup."
  }
}

解读一下这个结果：

  • ok: false — 操作失败了
  • type: "config" — 是配置层面的问题，不是命令本身有问题
  • subtype: "not_configured" — 明确说"还没配置"
  • hint 里给了解决方案：运行 lark-cli config init --new，它会在后台阻塞并输出一个验证链接，你需要把这个链接复制到浏览器里打开，完成初始化设置
💡配置流程

我们只是测试一下，不用真的自己输入 lark-cli config init --new，后续全部交给 Hermes 来完成后续工作。

5.4 后面的命令交给 Hermes

飞书 CLI 的命令域覆盖了飞书开放平台的所有能力：

能力域 作用
auth 登录、授权、检查当前身份和权限
config 管理 CLI 配置（App ID、密钥等）
docs 创建、读取和更新飞书云文档
markdown 创建、读取和覆盖 Drive 里的 Markdown 文件
drive 云空间/云盘文件管理（上传、下载、文件夹）
sheets 电子表格操作（读写单元格、样式、公式）
base 多维表格操作（字段、记录、视图）
wiki 管理知识库空间和节点
im 处理飞书消息和群聊
calendar 管理日历日程和会议室
approval 查询和处理审批待办/已办
task 管理任务、清单
mail 邮箱操作（收发、草稿、文件夹）
contact 通讯录查询（按姓名/邮箱查人）
minutes 妙记/会议纪要
vc 视频会议
attendance 考勤打卡
okr OKR 目标与关键结果
event 事件订阅
skill 技能管理

这些命令不应该由用户背下来。正确的方式是让 Hermes 自己去查：

Bash
lark-cli <domain> --help

这是飞书 CLI 有一个很重要的特点：它内置了面向 Agent 的使用提示。比如文档、多维表格、知识库这些能力，CLI 会提醒 Agent 先读取对应的内置 Skill，再选择具体命令。也就是说，Agent 时代的新式 CLI 不只是命令列表，还会附带“这些命令应该怎么用”的说明。

这正是我们希望看到的结构：CLI 给 Hermes 提供入口，Skill 给 Hermes 提供规则。

后面几节会继续做几个小案例：创建一篇测试文档、准备胶囊系统的飞书空间、创建多维表格、把文档链接写入索引表。但这些操作不要求读者手工输入每一条命令。读者只需要提出目标，Hermes 负责读取帮助、选择命令、执行操作和汇报结果。

5.5 本章后面只做基础铺垫

第七章不会直接实现胶囊系统。

这里要做的是给第九章铺路：先让读者知道 Hermes 怎样调用飞书 CLI，怎样确认本机环境可用，怎样创建一个文档，怎样创建一个多维表格，怎样把文档链接写进表格里。

等这些基础动作都理解了，第九章再把它们组合起来，就不会显得突然。到时候“证据页”“索引层”“主题页”这些词，就不只是抽象概念，而是可以落到飞书文档和多维表格里的具体对象。

5.6 ■ 学点英语

中文 English 音标 说明
企业系统 Enterprise System /ˈentərpraɪz ˈsɪstəm/ 服务组织协作、审批、文档和数据管理的软件系统
办公自动化 Office Automation /ˈɔːfɪs ˌɔːtəˈmeɪʃən/ 用程序处理办公系统中的重复操作
系统集成 System Integration /ˈsɪstəm integration/ 把多个软件系统连接成可协同工作的整体
业务对象 Business Object /ˈbɪznəs ˈɑːbdʒekt/ 业务系统中可被操作和管理的数据对象