很多团队在创作内容、建设知识库时，最难的往往不是“写一篇文档”。
一篇内容从本地 Markdown 初稿，到 AI 辅助修改，再到质检、发布、归档进知识库，中间常常要经历多次复制粘贴、格式调整和手动上传。流程一长，文档就容易散在本地、聊天记录和不同工具里，最后变成“写过，但不好找；整理过，但难复用”。
飞书 CLI 的价值，正是把飞书从一个“需要手动点击操作的协作工具”，变成一个可以被命令、脚本和 AI Agent 调用的工作系统。对内容创作者来说，它节省的不只是几次复制粘贴，而是让内容生产形成一条更稳定的流水线。
更重要的是，使用飞书 CLI 并不意味着你必须理解 API、OAuth、scope、token 这些技术概念。对于使用 Claude Code、Qoder、Codex、Cursor 等 AI Agent 工具的用户来说，只要完成基础配置，就可以直接用自然语言告诉 Agent 你想做什么：比如把本地 Markdown 创建成飞书文档，发布到指定知识库目录，搜索已有文档，或更新已有内容。
也就是说，你不需要记住每一条 CLI 命令，也不需要手动拼接复杂参数。你只需要在 Agent 里描述需求，让 AI 通过飞书 CLI 代你完成飞书里的操作。
本文主要面向还没有安装小龙虾、没有购买飞书aily，但已经在使用AI Agent的用户。
我们会以内容创作与管理为例，演示如何用一行命令完成安装，并在几分钟内上手，让 AI 帮你创建飞书文档、沉淀知识库。进一步扩展，它也可以用于总结昨日工作、整理群聊消息、批量更新多维表格数据等更多办公场景。
我们希望将更多真实用户的经验沉淀为可复用的方法，帮助更多团队在相似场景中获得参考。
一、有了飞书CLI，AI Agent 如何帮你完成文档创建？
以前的流程是：
AI输出 Markdown -> 人复制内容 -> 打开飞书 -> 找知识库目录 -> 新建文档 -> 粘贴排版 -> 检查发布
现在有了飞书CLI，流程变成：
AI输出 Markdown ->人对 Agent 说一句话 -> Agent 调用飞书 CLI -> 飞书知识库自动创建文档 -> Agent 返回链接
例如，你可以直接和 Agent 说：
帮我创建一篇飞书知识库文档，标题是《AI 产品经理学习路线》，放到社区知识库/AI通识，内容按入门、进阶、实战三部分写。
Agent 会理解这句话里的几个关键信息，然后帮你完成文档创建：
信息 | Codex 会怎么理解 |
创建一篇文档 | 调用飞书文档创建能力 |
飞书知识库 | 文档要放进 Wiki 知识库 |
标题 | 文档标题是《AI 产品经理学习路线》 |
社区知识库/AI通识 | 目标知识库目录 |
入门、进阶、实战 | 文档内容结构 |
完整流程分为 5 步。
第 1 步：用户在 Agent 中说需求
用户不需要写命令，只要描述目标。
例如：
帮我在飞书知识库中创建一篇文章，标题叫《如何判断一个 AI 产品机会》，放到社区知识库/AI产品经理-看这里。
或者：
帮我把本地的《RAG 是什么.md》发布到社区知识库/AI通识。
第 2 步： Agent 判断这是飞书的操作
Agent 会识别出这不仅是写作任务，还是一个飞书操作任务。
它会判断：
- 是创建新文档，还是发布已有 Markdown；
- 是否要放入知识库；
- 目标知识库目录是什么；
- 是否需要先生成正文；
- 是否需要调用飞书 CLI。
第 3 步： Agent 准备文档内容
如果你只给了标题和方向，Agent 会先生成文档正文。
如果你已经有本地 Markdown，Agent 会先检查文件：
标题是否存在
内容是否为空
是否有未完成标记、空链接等问题
这样可以避免把草稿或格式不完整的内容发到知识库里。
第 4 步： Agent 调用飞书 CLI 创建文档
配置好以后，Agent 会调用本机的飞书 CLI。
实际发生的事情是：
Codex -> lark-cli -> 飞书开放平台 -> 飞书知识库
这个过程中，飞书 CLI 会使用你已经授权过的飞书账号。
文档创建成功后，飞书会返回一个文档链接。
第 5 步： Agent 把结果返回给用户
创建成功后，Agent 会告诉你：
- 文档已经创建成功；
- 文档放到了哪个知识库目录；
- 飞书文档链接是什么；
- 如果需要，后续还可以继续更新、搜索或移动。
250px|700px|reset
二、第一次使用飞书CLI：按照这 3 步流程来！
第一次使用时，需要先把 Agent 和飞书 CLI 接起来。
这部分只需要做一次。
整体流程是：
安装 CLI -> 登录授权 -> 安装 Skills -> 重启 Codex -> 用自然语言操作飞书
第 1 步：安装飞书 CLI
飞书 CLI 是连接 Agent 和飞书的本地工具。
安装后，Agent 才能通过本机调用飞书能力。
方式一：手动安装
如果电脑已经安装了 Node.js 和 npm，可以选择手动安装。在终端中输入一行命令（Trae 建议通过这种方式安装）：
npm install -g @larksuite/cli
安装完成后，检查版本：
lark-cli --version
如果能看到类似下面的输出，说明安装成功：
lark-cli version 1.0.41
方式二：AI Agent 工具自动安装。
将以下信息发送给你的 AI Agent 工具（如 Cursor、Codex、Claude code），立即完成安装
帮我安装飞书 CLI：https://open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md
第 2 步：初始化并登录授权
安装 CLI 后，需要把它和你的飞书连接起来。
先初始化飞书 CLI：
lark-cli config init --new --brand feishu --lang zh
运行后，终端会给出一个飞书授权链接。打开链接，按页面提示完成应用创建和授权。
250px|700px|reset
然后登录推荐权限：
lark-cli auth login --recommend
推荐先用 --recommend，因为它会请求一组常用、相对安全的推荐权限，适合 AI Agent 日常操作飞书。
250px|700px|reset
授权完成后，可以检查状态：
lark-cli auth status --verify
如果看到 verified: true 和自己的飞书用户名，说明登录授权成功。
第 3 步：重启 Agent，然后用自然语言操作飞书
安装后，建议重启 Agent。
原因是：Agent 通常会在新会话启动时加载本地 skills。重启后，飞书的 lark-doc、lark-wiki、lark-base、lark-sheets 等能力会更完整地进入上下文。
之后就可以直接用自然语言操作飞书。
例如：
帮我在飞书知识库中创建一篇文章，标题叫《AI 产品机会判断方法》，放到社区知识库/AI产品经理-看这里。
或者：
帮我搜索飞书里关于 RAG 的文档。
Agent 会根据你的需求调用对应的飞书 CLI 能力，而不是让你自己记命令。
效果如下：
250px|700px|reset
三、这套流程适合用来做什么？
对内容工作者来说，这套流程最适合处理重复性工作。
场景一：创建一篇新知识库文章
你可以说：
参考知识库，创建一篇【AI产品经理是什么】的文章到飞书文档
Agent 会：
- 生成文章内容；
- 找到 社区知识库/AI通识 对应的飞书目录；
- 创建飞书知识库文档；
- 返回文档链接。
场景二：发布本地 Markdown
你可以说：
将文档【AI产品经理是什么.md】的发布到飞书文档
Agent 会：
- 找到本地 Markdown 文件；
- 做发布前检查；
- 调用飞书 CLI 创建知识库文档；
- 记录发布日志；
- 返回飞书链接。
场景三：搜索飞书文档
你可以说：
搜索一下「」相关的云文档
Agent 会：调用飞书搜索能力，把相关文档标题、链接和摘要返回给你。
场景四：更新已有文档
你可以说：
文章的结构需要再严谨一些，帮我更新云文档【AI产品经理是什么】
Agent 会：
- 识别文档链接；
- 准备要追加的内容；
- 调用飞书 CLI 更新文档；
- 告诉你是否更新成功。
场景五：让 AI 根据文档评论来修改文档
你可以说：
根据文章【AI产品经理是什么】的评论内容调整文档
Agent 会：
- 识别文档链接；
- 读取评论内容；
- 准备要修改的内容
- 调用飞书 CLI 更新文档；
- 告诉你是否更新成功。
场景六：批量发布文章
当本地已经有很多 Markdown 文章时，可以让 Agent 按目录批量发布。
例如：
帮我把 AI 通识模块的所有 Markdown 检查一遍，并逐篇发布到社区知识库/AI通识。
场景七、：维护内容目录
当知识库越来越大时，可以让 Agent 帮你查：
社区知识库/AI通识 下现在有哪些文章？
或者：
帮我找出飞书知识库里标题包含 Agent 的文档。
场景八：搭建内容运营后台
除了文档和知识库，飞书 CLI 还可以操作多维表格。
后续可以把文章状态管理成一个表：
字段 | 示例 |
标题 | RAG 是什么 |
模块 | AI 通识 |
状态 | 已发布 |
飞书链接 | https://... |
是否需要更新 | 否 |
下一步动作 | 增加案例 |
这样 Agent 不只是在发布文章，也可以逐步变成知识库运营助手。
四、飞书CLI 日常还可以怎么用
人与 AI 共创文档
写方案要反复和 AI 对话、复制粘贴、格式排版，效率低。现在有几种玩法：
- AI 起草，你来把关。 AI 在飞书文档里直接创建初稿，你在文档里用评论提修改意见，AI 读取评论、修改正文，持续迭代，全程不离开飞书。
- 你起草，AI 当审稿人。 你写好初稿后，让 AI 阅读全文，以评论的形式指出逻辑漏洞、数据缺失、表述不清的地方，和你在评论区讨论。就像有一个随时在线的资深同事帮你 review。
- Markdown 无缝转飞书文档。 你在 AI 工具里用 Markdown 写了一篇技术方案，想发给同事看？直接说"把这个 Markdown 创建成飞书文档"，Agent 自动转换格式，高亮块、表格、代码块、分栏全部保留。反过来也行，从飞书文档导出成 Markdown。
借助飞书cli，帮我把飞书知识库【AI Future-建设中】中【AI Future社区简介】这篇文档导出为markdown
250px|700px|reset
得到结果如下图：右侧就是导出的社区简介markdown文档。
250px|700px|reset
开完会，让 Agent 帮你办事
会议里随口提一句“我之后把那个文档发给你”，开完会就忘了。现在 Agent 直接从妙记里把这个待办识别出来，帮你把文档发了、会约了、调研做了。你只需要确认一下，剩下的它全干。
比如会上说要给谁发东西，Agent 帮你发。说回头试一个新产品，Agent 把链接找到发给你。说要约 follow up，Agent 查完日历直接把会建好。做之前会先让你过目。
进阶玩法：Wake Word 指令。你可以设置一个触发词（比如“龙虾龙虾”），开会的时候随口说“龙虾龙虾，帮我把这个方案整理成文档发给老板”，会后 Agent 自动从妙记逐字稿里识别出你的指令，提取为最高优先级待办，直接执行。你不需要记住自己在会上说了什么，Agent 替你记着。
读一下这个妙记，然后把里面的待办提取出来，直接帮我办了。做之前给我看一下你的计划。
跨时区多人智能约会
约一个 5 人会议，手动翻日历找共同空闲时间，来回沟通 20 分钟。团队还分布在不同时区，手动算时差更头疼。现在告诉 AI "帮我约这个群里的人下周开个会"，AI 自动拉群成员、查每个人的日历空闲、考虑所有人的时区，推荐几个"所有人都在合理工作时间"的选项。你选一个，会就建好了。
帮我看一下【XX】群里所有人的日历，然后下周找一个大家都合适的时间开一小时的讨论会
会议审计到多维表格仪表盘
你知道自己每天在开会，但不知道时间到底花在了哪里。一句话，Agent 拉取你过去两周的日历数据，自动给每场会议打标签（1:1/产品讨论/团队会/个人事务），写入多维表格，生成仪表盘。饼图看占比，柱状图看趋势。一张图告诉你该砍哪些会。
更进一步：Agent 批量分析你的妙记，给每场会打一个"产出密度"分数，哪些会没有产出任何决策、哪些议题在重复讨论，直接帮团队减负。
分析我过去一个月所有的会议妙记，给每场会打个产出分数，告诉我哪些会建议砍掉
AI根据过往日历信息，自动创建多维表格仪表盘
未读邮件智能分类与处理
每天收几十封邮件，混杂着通知、审批、客户邮件，手动整理费时费力。AI 定期扫描未读邮件，按优先级分类，重要邮件摘要推送到群聊，低优先级自动归档，还能帮每封邮件起草回复。
用 CLI 之后：AI 定期扫描未读邮件，按优先级分类，重要邮件摘要推送到群聊，低优先级自动归档。
飞书 CLI 的邮箱能力做了重点增强，补齐了增删改查的完整能力，让飞书邮箱也能融入 AI 工作流。
查看我所有的未读邮件，重要邮件发摘要到 aurora 项目群，并给每封邮件写一个草稿回复。
了解原理之后，想做什么就做什么
飞书CLI 现覆盖飞书最核心的业务域：即时消息、云文档、电子表格、多维表格、日历、视频会议、邮箱、任务、知识库、通讯录、搜索等，同时支持用户身份和应用身份两种认证，覆盖个人和企业场景。
目前功能也在持续快速迭代中，以下是详细能力列表：
业务域 | 能做什么 |
消息与群组 | 搜索消息和群聊、发消息、回复话题、管理成员与表情回应、收发图片文件 |
云文档 | 创建文档、读取内容、更新正文、插入图片附件、搜索云文档 |
云空间 | 上传下载文件、整理目录、导入导出文档、管理权限、处理评论 |
电子表格 | 创建表格、读写单元格、批量追加、查找替换、筛选视图、导出下载 |
多维表格 | 管理数据表、字段、记录、视图、表单、仪表盘、自动化与权限角色 |
日历 | 查日程、约会议、查忙闲、推荐时间、预定会议室、回复邀约 |
视频会议 | 搜索会议、获取纪要和逐字稿、关联日程文档 |
妙记 | 搜索妙记、下载音视频、获取总结待办章节 |
邮箱 | 搜索、读取、起草、发送、回复、转发、归档邮件，管理文件夹标签规则 |
任务 | 创建任务、更新状态、拆分子任务、管理清单和协作成员 |
知识库 | 查询空间、管理成员、管理节点和文档层级 |
通讯录 | 查询用户、搜索同事、查看部门 |
幻灯片 | 创建演示文稿、读取页面内容、增删幻灯片 |
画板 | 读取画板、导出图片、用 DSL/PlantUML/Mermaid 更新画板 |
OKR | 查看周期、管理目标与关键结果、维护对齐关系和量化指标 |
审批 | 查询审批实例、处理审批任务 |
考勤 | 查询考勤打卡记录 |
五、常见问题
1. 为什么有时候还会看到命令？
Codex 背后仍然是通过飞书 CLI 操作飞书。
区别是：你不需要自己记命令，Codex 会根据你的自然语言选择合适的命令。
如果遇到权限、网络或格式问题，Codex 可能会把关键命令展示出来，方便你知道卡在哪里。
2. 为什么第一次需要授权？
因为 Codex 要代表你的飞书账号创建和编辑文档。
飞书需要确认：
- 你是谁；
- 你是否允许这个 CLI 应用操作文档；
- 你允许它操作哪些范围。
授权完成后，后续就不用每次都重新登录。
3. 如果提示缺少权限怎么办？
通常报错会告诉你缺哪个权限。
例如：
missing required scope(s): search:docs:read
这表示还没有授权“搜索文档”的能力。
解决方式是按提示打开飞书授权链接，确认授权即可。
