借助飞书CLI用自然语言操作飞书创建云文档

–想看如何安装和授权相关的直接跳转到第四部分。

一、结论在前

1、为什么要用飞书 CLI，飞书 CLI 的核心价值，是把飞书从“只能手动点击的协作工具”，变成“可以被命令、脚本和 AI Agent 调用的工作系统”。

对知识库建设来说，它最大的优势不是省下几次复制粘贴，而是让内容生产形成一条可持续的流水线：

写作 → AI 修改 → 质检 → CLI 发布 → 飞书知识库沉淀

2、在这套流水线里，你不需要懂 API，也不需要理解 OAuth、scope、token 这些词背后的技术细节。你只需要知道：飞书 CLI 最大的特点是暂时支持AI Agent。

就是你在 Claude Code、Qoder、Codex 这些 Agent 工具里，不需要任何额外配置，Agent 可以直接调用 CLI 来操作飞书。它可以把本地 Markdown 文档创建成飞书文档，并放到指定的飞书知识库目录里。

你不需要记飞书 CLI 命令，也不需要理解每个 API 参数。你只需要知道：当飞书 CLI 和 Codex 配置好以后，可以直接在 Codex 里用自然语言说需求，让 Codex 帮你在飞书知识库里创建文档、搜索文档、更新文档和发布本地 Markdown。

3、我们这篇文档主要是给没有安装小龙虾、没有购买飞书aily的小伙伴看的。如果在飞书装了飞书的小龙虾或者购买了飞书AILY，整个过程将无比丝滑，基本可以通过直接通过自然语言完成下面的目标。

适合人群：主要使用 Claude Code、Codex、Cursor 等 AI 工具的小伙伴、没有购买aily的小伙伴、不想额外花token的小伙伴。

目标：让这些小伙伴直接安装 CLI，让 AI 代你操作飞书，直接一句话创建飞书文档，扩展来说，还可以帮助大家总结昨日工作、整理群聊消息、批量更新多维表格数据等。一行命令完成安装，几分钟即可上手。

以下内容以借助飞书CLI用自然语言操作飞书创建文档为例。

二、一句话理解

以前的流程是（以下都以codex为例）：见下图：

现在的流程可以变成：

AI输出 Markdown ->我对 Codex 说一句话 -> Codex 调用飞书 CLI -> 飞书知识库自动创建文档 -> Codex 返回链接。

例如可以直接说：帮我创建一篇飞书知识库文档，标题是《AI 产品经理学习路线》，放到社区知识库/AI通识，内容按入门、进阶、实战三部分写。

Codex 会理解这句话里的几个关键信息，然后帮你完成文档创建：

三、整体流程

完整流程分为 5 步。

第 1 步：用户在 Codex 中说需求

用户不需要写命令，只要描述目标。例如：帮我在飞书知识库中创建一篇文章，标题叫《如何判断一个 AI 产品机会》，放到社区知识库/AI产品经理-看这里。或者：帮我把本地的《RAG 是什么.md》发布到社区知识库/AI通识。

下图是AI产出的.md的文档，经过人工检查没有问题后，让AI创建飞书文档。

第 2 步：Codex 判断这是飞书的什么操作

Codex 会识别出这不仅是写作任务，还是一个飞书操作任务。

它会判断：

1. 是创建新文档，还是发布已有 Markdown；

2. 是否要放入知识库；

3. 目标知识库目录是什么；

4. 是否需要先生成正文；

5. 是否需要调用飞书 CLI。

第 3 步：Codex 准备文档内容

如果你只给了标题和方向，Codex 会先生成文档正文。

如果你已经有本地 Markdown，Codex 会先检查文件：

标题是否存在内容是否为空是否有未完成标记、空链接等问题

这样可以避免把草稿或格式不完整的内容发到知识库里。

第 4 步：Codex 调用飞书 CLI 创建文档

配置好以后，Codex 会调用本机的飞书 CLI。

实际发生的事情是：

Codex -> lark-cli -> 飞书开放平台 -> 飞书知识库

这个过程中，飞书 CLI 会使用你已经授权过的飞书账号。

文档创建成功后，飞书会返回一个文档链接。

第 5 步：Codex 把结果返回给用户

创建成功后，Codex 会告诉你：

1. 文档已经创建成功；

2. 文档放到了哪个知识库目录；

3. 飞书文档链接是什么；

4. 如果需要，后续还可以继续更新、搜索或移动。

   见下图：

   

四、第一次使用：官方推荐的 5 步流程

第一次使用时，需要先把 Codex 和飞书 CLI 接起来。这部分只需要做一次。整体流程是：

安装 CLI -> 登录授权 -> 安装 Skills -> 重启 Codex -> 用自然语言操作飞书。

第 1 步：安装飞书 CLI

飞书 CLI 是连接 Codex 和飞书的本地工具。安装后，Codex 才能通过本机调用飞书能力。

如果电脑已经安装了 Node.js 和 npm，可以直接在终端运行命令（记住全局安装，别特地去选个文件夹）：

npm install -g @larksuite/cli

如果遇到 npm 官方源连接慢，可以使用镜像源：

npm install -g @larksuite/cli --registry=https://registry.npmmirror.com

安装完成后，检查版本：

lark-cli --version

如果能看到类似下面的输出，说明安装成功：lark-cli version 1.0.31

第 2 步：初始化并登录授权

安装 CLI 后，需要把它和你的飞书账号连接起来。先初始化飞书 CLI：lark-cli config init –new –brand feishu –lang zh

运行后，终端会给出一个飞书授权链接。打开链接，按页面提示完成应用创建和授权。

然后登录推荐权限：

lark-cli auth login --recommend

官方推荐先用 --recommend，因为它会请求一组常用、相对安全的推荐权限，适合 AI Agent 日常操作飞书。

授权完成后，可以检查状态：

lark-cli auth status --verify

如果看到 verified: true 和自己的飞书用户名，说明登录授权成功。

第 3 步：安装飞书 Agent Skills

飞书官方提供了一组 Agent Skills。它们的作用是告诉 Codex：

1. 飞书有哪些能力；

2. 创建文档应该怎么调用；

3. 搜索文档应该怎么调用；

4. 知识库目录应该怎么处理；

5. 权限不足时应该怎么补授权。

安装后，Codex 才能更稳定地把自然语言翻译成飞书操作。

安装时，直接和你当前正在使用的AI，例如codex说：

帮我安装飞书 CLI skill：
https://open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md

安装完成后，会提示你重启codex。中间遇到授权记得通过授权，遇到问题，直接问AI怎么解决，你的AI会告诉你如何解决。

第 5 步：重启 Codex，然后用自然语言操作飞书

安装 Agent Skills 后，建议重启 Codex。

原因是：Codex 通常会在新会话启动时加载本地 skills。重启后，飞书的 lark-doc、lark-wiki、lark-base、lark-sheets 等能力会更完整地进入 Codex 的上下文。

之后就可以直接用自然语言操作飞书。例如：

帮我在飞书知识库中创建一篇文章，标题叫《AI 产品机会判断方法》，放到社区知识库/AI产品经理-看这里。

或者：帮我搜索飞书里关于 RAG 的文档。

Codex 会根据你的需求调用对应的飞书 CLI 能力，而不是让你自己记命令。

效果如下：图片中的案例是输出一个写着我名字的飞书文档。

五、这套流程适合用来做什么

对知识库建设来说，这套流程最适合处理重复性工作。

场景一：创建一篇新知识库文章

你可以说：参考知识库，创建一篇【AI产品经理是什么】的文章到飞书文档。Codex 会：

1. 生成文章内容；

2. 找到 社区知识库/AI通识 对应的飞书目录；

3. 创建飞书知识库文档；

4. 返回文档链接。

场景二：发布本地 Markdown

你可以说：将文档【AI产品经理是什么.md】的发布到飞书文档

Codex 会：

1. 找到本地 Markdown 文件；

2. 做发布前检查；

3. 调用飞书 CLI 创建知识库文档；

4. 记录发布日志；

5. 返回飞书链接。

场景三：搜索飞书文档

你可以说：搜索一下functioncall相关的云文档。

1. Codex 会调用飞书搜索能力，把相关文档标题、链接和摘要返回给你。

场景四：更新已有文档

你可以说：文章的结构需要在严谨一些，帮我更新云文档【AI产品经理是什么】

Codex 会：

1. 识别文档链接；

2. 准备要追加的内容；

3. 调用飞书 CLI 更新文档；

4. 告诉你是否更新成功。

场景五：让Ai根据文档评论来修改文档

你可以说：根据文章【AI产品经理是什么】的评论内容调整文档

Codex 会：

1. 识别文档链接；

2. 读取评论内容；

3. 准备要修改的内容

4. 调用飞书 CLI 更新文档；

5. 告诉你是否更新成功。

场景六、批量发布文章

当本地已经有很多 Markdown 文章时，可以让 Codex 按目录批量发布。

例如：

帮我把 AI 通识模块的所有 Markdown 检查一遍，并逐篇发布到社区知识库/AI通识。

场景七、 维护内容目录

当知识库越来越大时，可以让 Codex 帮你查：

社区知识库/AI通识 下现在有哪些文章？

或者：

帮我找出飞书知识库里标题包含 Agent 的文档。

场景八、搭建内容运营后台

除了文档和知识库，飞书 CLI 还可以操作多维表格。

后续可以把文章状态管理成一个表：

这样 Codex 不只是在发布文章，也可以逐步变成知识库运营助手。

六、日常还可以怎么用

配置完成后，日常使用就很简单。

1、人与 AI 共创文档

写方案要反复和 AI 对话、复制粘贴、格式排版，效率低。现在有两种玩法：

AI 起草，你来把关。 AI 在飞书文档里直接创建初稿，你在文档里用评论提修改意见，AI 读取评论、修改正文，持续迭代，全程不离开飞书。

你起草，AI 当审稿人。 你写好初稿后，让 AI 阅读全文，以评论的形式指出逻辑漏洞、数据缺失、表述不清的地方，和你在评论区讨论。就像有一个随时在线的资深同事帮你 review。

Markdown 无缝转飞书文档。 你在 AI 工具里用 Markdown 写了一篇技术方案，想发给同事看？直接说”把这个 Markdown 创建成飞书文档”，agent 自动转换格式，高亮块、表格、代码块、分栏全部保留。反过来也行，从飞书文档导出成 Markdown。

2、开完会，事就办了

会议里随口提一句“我之后把那个文档发给你”，开完会就忘了。现在 agent 直接从妙记里把这个待办识别出来，帮你把文档发了、会约了、调研做了。你只需要确认一下，剩下的它全干。

比如会上说要给谁发东西，agent 帮你发。说回头试一个新产品，agent 把链接找到发给你。说要约 follow up，agent 查完日历直接把会建好。做之前会先让你过目。

进阶玩法：Wake Word 指令。你可以设置一个触发词（比如“龙虾龙虾”），开会的时候随口说“龙虾龙虾，帮我把这个方案整理成文档发给老板”，会后 agent 自动从妙记逐字稿里识别出你的指令，提取为最高优先级待办，直接执行。你不需要记住自己在会上说了什么，agent 替你记着。

读一下这个妙记，然后把里面的待办提取出来，直接帮我办了。做之前给我看一下你的计划。

3、跨时区多人智能约会

约一个 5 人会议，手动翻日历找共同空闲时间，来回沟通 20 分钟。团队还分布在不同时区，手动算时差更头疼。现在告诉 AI “帮我约这个群里的人下周开个会”，AI 自动拉群成员、查每个人的日历空闲、考虑所有人的时区，推荐几个”所有人都在合理工作时间”的选项。你选一个，会就建好了。

帮我看一下【XX】群里所有人的日历，然后下周找一个大家都合适的时间开一小时的讨论会

4、会议审计到多维表格仪表盘

你知道自己每天在开会，但不知道时间到底花在了哪里。一句话，agent 拉取你过去两周的日历数据，自动给每场会议打标签（1:1/产品讨论/团队会/个人事务），写入多维表格，生成仪表盘。饼图看占比，柱状图看趋势。一张图告诉你该砍哪些会。

更进一步：agent 批量分析你的妙记，给每场会打一个”产出密度”分数，哪些会没有产出任何决策、哪些议题在重复讨论，直接帮团队减负。

分析我过去一个月所有的会议妙记，给每场会打个产出分数，告诉我哪些会建议砍掉

AI根据过往日历信息，自动创建多维表格仪表盘

5、未读邮件智能分类与处理

每天收几十封邮件，混杂着通知、审批、客户邮件，手动整理费时费力。AI 定期扫描未读邮件，按优先级分类，重要邮件摘要推送到群聊，低优先级自动归档，还能帮每封邮件起草回复。

用 CLI 之后：AI 定期扫描未读邮件，按优先级分类，重要邮件摘要推送到群聊，低优先级自动归档。

飞书 CLI 的邮箱能力做了重点增强，补齐了增删改查的完整能力，让飞书邮箱也能融入 AI 工作流。

查看我所有的未读邮件，重要邮件发摘要到 aurora 项目群，并给每封邮件写一个草稿回复。

6、了解原理之后，想做什么就做什么

你的 AI 缺两样东西：context 和手

市面上的 AI 模型都很聪明，但聪明不等于有用。一个 AI 如果不知道你今天开了什么会、跟谁聊了什么、手上有哪些待办，它就只能给你通用的回答。而且就算它知道了，如果不能直接帮你操作飞书，它还是只能说”你应该去建个文档”，而不是替你建。

飞书 CLI 同时解决了这两个问题：让 AI 拿到你在飞书上沉淀的所有工作 context（消息、文档、日历、妙记、多维表格），同时给它操作这些东西的能力。既能看，也能动手。

为 AI 而设计

飞书 CLI 不是把现有 API 简单包装成命令行。它是为 AI Agent 的使用方式专门设计的：出错时告诉 AI 怎么修（不只是”错了”），缺权限时自动引导补授权，命令设计上优化了 token 消耗。AI 用它的成功率远高于直接调 API。

全面开源，自由调用

不管你用 Claude Code、Codex、Cursor 还是其他 Agent，只要能跑命令行，就能通过 CLI 操作飞书。无需登记，无需审核。

覆盖全，迭代快

目前覆盖飞书最核心的业务域：即时消息、云文档、电子表格、多维表格、日历、视频会议、邮箱、任务、知识库、通讯录、搜索等。不少是此前 API 缺失、开发者呼声最高的能力。同时支持用户身份和应用身份两种认证，覆盖个人和企业场景。持续快速迭代中。

七、常见问题

1. 为什么有时候还会看到命令？

Codex 背后仍然是通过飞书 CLI 操作飞书。

区别是：你不需要自己记命令，Codex 会根据你的自然语言选择合适的命令。

如果遇到权限、网络或格式问题，Codex 可能会把关键命令展示出来，方便你知道卡在哪里。

2. 为什么第一次需要授权？

因为 Codex 要代表你的飞书账号创建和编辑文档。

飞书需要确认：

1. 你是谁；

2. 你是否允许这个 CLI 应用操作文档；

3. 你允许它操作哪些范围。

授权完成后，后续就不用每次都重新登录。

3. 如果提示缺少权限怎么办？

通常报错会告诉你缺哪个权限。

例如：

missing required scope(s): search:docs:read

这表示还没有授权“搜索文档”的能力。

解决方式是按提示打开飞书授权链接，确认授权即可。

4. 如果提示 keychain 问题怎么办？

飞书 CLI 的登录信息保存在 Mac 的钥匙串里。

如果 Codex 读不到钥匙串，可能会出现：

keychain not initialized

这时需要在本机终端重新登录飞书 CLI，或者确认 Codex 当前环境能读取本机授权。

八、给用户的最短使用说明

如果你只想快速使用，可以记住这 3 句话。

创建知识库文档

帮我在社区知识库/AI通识下创建一篇文章，标题是《xxx》，内容围绕 xxx 展开。

发布本地 Markdown

帮我把《xxx.md》发布到社区知识库/AI通识。

搜索飞书内容

帮我搜索飞书里关于 xxx 的文档。

九、小结

通过 Codex 自然语言操作飞书知识库，本质上是把三件事连接起来：

自然语言需求 -> Codex 理解和生成内容 -> 飞书 CLI 执行创建/搜索/更新

配置完成后，用户不需要学习飞书 API，也不需要记命令。

只要说清楚：

1. 要做什么；

2. 文档标题是什么；

3. 放到哪个知识库目录；

4. 内容大概怎么写；

Codex 就可以帮你把文档创建到飞书知识库里。

十、参考资料