你不得不承认，大模型越来越聪明了，能理解需求、拆解任务、生成方案，甚至已经是一个“会思考的助理”。
但它会想，却不一定能做。
对一个真正可用的 AI Agent 来说，价值从来不只在“回答得对”，而在于“能不能把事办完”。它不仅要理解你的意图，还要真正进入你的工作环境，读取上下文、调用工具、执行操作，并把结果落到具体的业务系统里。否则，再聪明的 Agent，也只能停留在聊天框里。
这正是很多 AI Agent 落地时的关键瓶颈。很多时候，它给出的仍然只是“一段建议”，最后还得由人手动复制、粘贴、转发、搬运 feedback。
这正是飞书 CLI（lark-cli）的价值所在。作为飞书官方开源的命令行工具，它为 AI Agent 提供了连接飞书业务系统的标准化执行入口。接入后，Agent 不再停留在生成建议或输出文本的层面，而是可以直接读消息、查日历、写文档、建多维表格、发邮件，把任务真正落到飞书里完成。
从这个意义上说，飞书 CLI 解决的不是“再给 Agent 增加一个工具”，而是补上了 Agent 从理解到执行的关键一环，让 AI 能更自然地进入实际协作流程。
本文将详细介绍飞书 CLI 是什么、如何安装、覆盖哪些业务能力，以及哪些场景最适合使用它。
一、飞书 CLI 是什么
飞书 CLI（Command Line Interface）是飞书官方开源的命令行工具，旨在为 AI Agent 提供操作飞书的能力。
传统的 AI 对话是一个"三人群聊"：你、AI、你的电脑。以前的问题是——飞书不在这个群里。AI 再聪明，和飞书之间没有沟通渠道，所以它只能给建议，不能帮你干活。
飞书 CLI 把飞书拉进了这个群聊。装上之后，AI Agent 可以直接和飞书对话：
- 读取你的飞书消息和群聊记录
- 查询和创建日历事件
- 读写飞书云文档
- 管理和操作多维表格
- 发送和阅读邮件
- 搜索知识库和通讯录
对于使用 Trae、Claude Code、Codex、Cursor 等 AI 编程工具的用户而言，这意味着你可以直接让 AI 替你操作飞书——你只管拍板，具体的事 AI 来干。
核心定位：飞书 CLI 不是简单包装现有 API，而是为 AI Agent 使用方式专门设计的工具。出错时告诉 AI 怎么修复，缺权限时自动引导补授权，命令设计上优化了 token 消耗。用 AI 调用 CLI 的成功率远高于直接调 API。
CLI 跟普通用户有什么关系
你完全不需要学它，甚至不需要知道它存在。
CLI 的安装是一次性的。安装完成后，你只需用自然语言跟 AI Agent 对话，AI 会自己用 CLI 去操作飞书。你只需要说"帮我把这件事办了"，AI 就替你做了。
打个比方：以前是你操作电脑，现在你有了私人助理——你只管下达指令，助理（AI + CLI）替你执行。你不需要学命令行，就像你不需要懂汽车发动机也能打车一样。
谁适合使用飞书 CLI
1. 使用 Trae、Claude Code、Codex、Cursor 的用户
直接安装 CLI，让 AI 代你操作飞书——总结昨日工作、整理群聊消息、批量更新多维表格数据。一行命令完成安装，几分钟即可上手。
2. 构建企业级 AI Agent 的团队
如果你正在开发需要与飞书深度集成的 AI 产品——无论是 AI 员工、AI 客服还是自动化工作流——CLI 提供飞书官方推荐的最佳实践，覆盖核心业务域的高频操作，同时支持用户身份与应用身份，可直接集成进你的 Agent。
3. 使用 OpenClaw 的用户（敬请期待）
如果你在 OpenClaw 中安装了飞书插件，OpenClaw 即将基于这套 CLI 能力升级插件底层。升级完成后，无需自行安装 CLI，直接用自然语言与 AI 对话即可操作飞书。
二、飞书CLI 快速安装与配置
- 环境要求
- Node.js 16.0 及以上版本
- npm 或 yarn
- 安装步骤
第一步：安装 lark-cli
将以下命令发送给 AI Agent 工具（如 Trae、Cursor、Codex、Claude code）：
npm install -g @larksuite/cli
第二步：安装相关 Skills
npx skills add https://github.com/larksuite/cli -y -g
第三步：初始化应用配置
lark-cli config init --new
配置过程中，默认会创建一个新应用，也可以选择一个已有应用。
注意：为了确保 skills 完整加载，配置完成后需要重启你的 AI Agent 工具（如 Trae、Cursor、Codex、Claude code），然后便可以发送指令开始操作飞书。
- 完成用户授权（可选）
飞书 CLI 支持两种工作模式：
- 不授权：AI 仍可执行发消息、创建文档等操作，但无法访问你的个人数据（如日程、私信、收件箱）。
- 以你的身份操作：AI 可以访问你的个人日历、消息、文档，并以你的名义执行操作。需要完成一次用户授权。
lark-cli auth login
执行命令后，打开链接在飞书中确认即可。如果暂时跳过，后续 AI 在需要访问你个人数据时，也会自动发起授权提示。
提示：如果需要保持授权状态，请在开发者后台（安全设置 → 重定向 URL → 刷新 user_access_token）开启该能力。
- 验证安装
lark-cli help # 查看命令总览
lark-cli auth status # 查看当前登录状态
250px|700px|reset
- 开启你的第一个任务
打开你的 AI Agent 工具（如 Trae、Cursor、Claude Code），在对话框中输入：
帮我创建一篇云文档，介绍飞书 CLI 的能力有哪些，以及基于你对我的了解，我可以先开始用哪些能力
三、飞书CLI 核心能力详解
飞书 CLI 目前已覆盖飞书最核心的业务域，以下是各业务域的完整能力清单：
业务域 | 核心能力 |
消息与群组 | 搜索消息和群聊、发送消息、回复话题 |
云文档 | 创建文档、读取内容、更新正文、评论协作 |
云空间 | 上传下载文件、管理权限、处理评论 |
电子表格 | 创建表格、读写单元格、批量更新 |
多维表格 | 管理数据表、字段、记录、视图、仪表盘、自动化 |
日历 | 查询日程、创建会议、查询忙闲、推荐时间 |
视频会议 | 搜索会议、获取纪要和逐字稿、关联日程文档 |
邮箱 | 搜索、读取、起草、发送、回复、归档邮件 |
任务 | 创建任务、更新状态、管理清单和子任务 |
知识库 | 查询空间、管理节点和文档层级 |
通讯录 | 查询用户、搜索同事、查看部门 |
搜索 | 搜索群聊、消息、文档等 |
亮点能力：飞书 CLI 的邮箱模块做了重点增强，补齐了增删改查的完整能力，让飞书邮箱也能融入 AI 工作流。此外，视频会议纪要和妙记逐字稿的获取能力也是此前开发者呼声最高的功能。
四、飞书CLI 典型使用场景
场景 1：开完会，事就办了
会议里随口提一句“我之后把那个文档发给你”，开完会就忘了。现在 agent 直接从妙记里把这个待办识别出来，帮你把文档发了、会约了、调研做了。你只需要确认一下，剩下的它全干。
比如会上说要给谁发东西，agent 帮你发。说回头试一个新产品，agent 把链接找到发给你。说要约 follow up，agent 查完日历直接把会建好。做之前会先让你过目。
进阶玩法：Wake Word 指令。你可以设置一个触发词（比如“龙虾龙虾”），开会的时候随口说“龙虾龙虾，帮我把这个方案整理成文档发给老板”，会后 agent 自动从妙记逐字稿里识别出你的指令，提取为最高优先级待办，直接执行。你不需要记住自己在会上说了什么，agent 替你记着。
读一下这个妙记，然后把里面的待办提取出来，直接帮我办了。做之前给我看一下你的计划。
场景 2：人与 AI 共创文档
写方案要反复和 AI 对话、复制粘贴、格式排版，效率低。现在有两种玩法：
AI 起草，你来把关。 AI 在飞书文档里直接创建初稿，你在文档里用评论提修改意见，AI 读取评论、修改正文，持续迭代，全程不离开飞书。
你起草，AI 当审稿人。 你写好初稿后，让 AI 阅读全文，以评论的形式指出逻辑漏洞、数据缺失、表述不清的地方，和你在评论区讨论。就像有一个随时在线的资深同事帮你 review。
Markdown 无缝转飞书文档。 你在 AI 工具里用 Markdown 写了一篇技术方案，想发给同事看？直接说"把这个 Markdown 创建成飞书文档"，agent 自动转换格式，高亮块、表格、代码块、分栏全部保留。反过来也行，从飞书文档导出成 Markdown。
模式 A：写文档
根据我的所在部门、飞书消息、飞书云文档、日程等信息，帮我创建一篇飞书云文档，写一篇个人使用说明书。
250px|700px|reset
{{文档链接}} 根据我的评论修改文档，修改后，用划词评论标识出修改点。
250px|700px|reset
250px|700px|reset
模式 B：AI 当审稿人
{{文档链接}}阅读一下这篇文档，看下作为提供给外部用户的说明文档，是否足够清晰、简洁。不要直接改文档，只把你觉得有优化空间的位置划词评论出来，在评论里写上修改意见。
250px|700px|reset
模式 C：Markdown转飞书文档
把这篇 Markdown 内容创建成飞书文档，排版要好看
场景 3：跨时区多人智能约会
约一个 5 人会议，手动翻日历找共同空闲时间，来回沟通 20 分钟。团队还分布在不同时区，手动算时差更头疼。现在告诉 AI "帮我约这个群里的人下周开个会"，AI 自动拉群成员、查每个人的日历空闲、考虑所有人的时区，推荐几个"所有人都在合理工作时间"的选项。你选一个，会就建好了。
帮我看一下【XX】群里所有人的日历，然后下周找一个大家都合适的时间开一小时的讨论会
250px|700px|reset
场景 4：会议审计到多维表格仪表盘
你知道自己每天在开会，但不知道时间到底花在了哪里。一句话，agent 拉取你过去两周的日历数据，自动给每场会议打标签（1:1/产品讨论/团队会/个人事务），写入多维表格，生成仪表盘。饼图看占比，柱状图看趋势。一张图告诉你该砍哪些会。
更进一步：agent 批量分析你的妙记，给每场会打一个"产出密度"分数，哪些会没有产出任何决策、哪些议题在重复讨论，直接帮团队减负。
拉取我过去两周的日历，把每个日程分类打标，写入多维表格，然后做一个仪表盘，我要看时间花在了哪里
分析我过去一个月所有的会议妙记，给每场会打个产出分数，告诉我哪些会建议砍掉
AI根据过往日历信息，自动创建多维表格仪表盘：
250px|700px|reset
场景 5：未读邮件智能分类与处理
每天收几十封邮件，混杂着通知、审批、客户邮件，手动整理费时费力。AI 定期扫描未读邮件，按优先级分类，重要邮件摘要推送到群聊，低优先级自动归档，还能帮每封邮件起草回复。
用 CLI 之后：AI 定期扫描未读邮件，按优先级分类，重要邮件摘要推送到群聊，低优先级自动归档。
飞书 CLI 的邮箱能力做了重点增强，补齐了增删改查的完整能力，让飞书邮箱也能融入 AI 工作流。
查看我所有的未读邮件，重要邮件发摘要到 aurora 项目群，并给每封邮件写一个草稿回复。
250px|700px|reset
250px|700px|reset
五、为什么选飞书 CLI
你的 AI 缺两样东西：context 和手
市面上的 AI 模型都很聪明，但聪明不等于有用。一个 AI 如果不知道你今天开了什么会、跟谁聊了什么、手上有哪些待办，它就只能给你通用的回答。
而且就算它知道了，如果不能直接帮你操作飞书，它还是只能说"你应该去建个文档"，而不是替你建。
飞书 CLI 同时解决了这两个问题：让 AI 拿到你在飞书上沉淀的所有工作 context（消息、文档、日历、妙记、多维表格），同时给它操作这些东西的能力。既能看，也能动手。
为 AI Agent 使用方式专门设计
飞书 CLI 不是把现有 API 简单包装成命令行工具。它有几个专为 AI 设计的关键特性：
- 错误提示优化：出错时告诉 AI 怎么修复，不只是说"错了"
- 权限引导：缺权限时自动引导补授权，不让 AI 卡住
- Token 消耗优化：命令设计上考虑了 AI 的调用成本
- 高成功率：AI 用 CLI 调用的成功率远高于直接调 API
全面开源，无需登记
飞书 CLI 现已正式开源，面向所有用户开放。无需登记，无需审核。无论你想让 Claude Code、Codex 还是其他 Agent 直接操作飞书，欢迎立即获取代码，即刻上手。
覆盖全，迭代快
目前已覆盖即时消息、云文档、电子表格、多维表格、日历、视频会议、邮箱、任务、知识库、通讯录、搜索等核心业务域，不少是此前 API 缺失、开发者呼声最高的能力。同时支持用户身份和应用身份两种认证，覆盖个人和企业场景。
六、常见问题解答 FAQs
企业管理员有办法控制权限吗？
CLI 只是提供一键创建应用的能力，应用的管控仍然 follow 企业统一管控规则。企业管理员可以在飞书开放平台后台对应用权限进行统一管理。
安装后提示命令不存在？
确认 CLI 所在目录已加入系统 PATH。npm 安装后可执行 npm root -g 查看全局目录，将该路径加入 PATH 即可。
授权失败，提示"授权码已过期"？
OAuth 授权码有效期只有几分钟，超时后重新执行 lark-cli auth login 即可。
调用 API 提示权限不足？
根据报错提示补充授权：lark-cli auth login --scope "<missing_scope>"。CLI 会告诉你缺少什么权限，并提供申请链接。应用身份调用还需在飞书开放平台后台开通对应权限。
支持国际版 Lark 吗？
支持。通过 lark-cli config init 并配置国际版 Lark 的应用即可使用。
CLI 和 OpenClaw 飞书官方插件是什么关系？
OpenClaw 等平台上的飞书官方插件，底层就是基于这套 CLI 构建的。如果你已经在用飞书插件，不需要再单独安装 CLI——直接用就行，插件的能力会很快和 CLI 对齐。
如何获取更多帮助？
- 执行 lark-cli help 查看命令总览
- 执行 lark-cli <command> --help 查看具体用法
- 使用 lark-cli schema 命令可快速查询接口详情
