lark-cli：飞书官方命令行工具，把飞书操作交给终端和智能体

每天在飞书里做的事，有多少是重复的？查日程、发消息、开文档、看审批……点鼠标点得越熟练，越说明这些操作不该由人肉完成。lark-cli 就是飞书开放平台的官方命令行工具——它把这些操作全部变成终端命令，让人能敲，更让 AI Agent 能直接调用。

适用：开发者 / 效率工具爱好者 / 想用智能体自动化飞书的人 ｜ 更新：2026-09-05

一、lark-cli 是什么？

一句话：飞书官方出的 CLI，专为「人类 + AI Agent」设计。

它由 larksuite 团队维护（MIT 开源），不是第三方野路子工具。GitHub 上 16k+ star，覆盖 18 个业务域、200+ 条精选命令，还内置了 26 个给 AI Agent 用的现成技能（Skills）。

它和「用代码调飞书 API」的区别在于：API 要自己拼请求、管 token、处理分页，而 lark-cli 把这些全封装好了——装完、登录、直接敲命令。

二、三层命令架构：从快到全

lark-cli 最有设计感的地方，是它把命令分成三层，按场景选粒度：

• 想快速看今天日程 → 用 +agenda 快捷命令；
• 要精确操作某个端点 → 用 API 命令；
• 官方没精选的冷门接口 → 直接用通用 API 兜底。

同一件事有三种粒度可选，这是它和普通 CLI 最大的不同——上手门槛低，但天花板很高，不会用两天就撞到「这个命令没有」的墙。

三、能操作什么：覆盖 18 个业务域

日常办公高频的那几件事——IM、日历、文档、表格——基本全覆盖了。这意味着一个人+一个终端，就能批量操作整个飞书工作台。

四、3 分钟上手

1. 安装

npx @larksuite/cli@latest install

或全局安装：

npm install -g @larksuite/cli

2. 初始化应用凭据

lark-cli config init --new

这条命令会走交互式引导，创建一个 CLI 应用实例。如果让 AI Agent 跑，它会输出一个授权 URL 给你，你在浏览器里完成配置后命令自动退出。

3. 登录授权

lark-cli auth login --recommend

--recommend 会自动勾选常用权限范围，省得手动一个个选。之后随时可以用 lark-cli auth status 查看登录状态和已授权范围。

从安装到第一次调通 API，三步搞定，全程不需要手写一行鉴权代码。

五、对 AI Agent 格外友好：这才是它的杀手锏

lark-cli 的定位不只是「给人用的终端工具」，它从一开始就是为 AI Agent 设计的——这一点和普通 CLI 有本质区别：

1. 24+ 个现成 Skills：lark-im（发消息）、lark-calendar（日程）、lark-doc（文档）、lark-base（多维表格）、lark-mail（邮箱）…… 每个都是结构化定义好的技能包，兼容主流 AI 工具，智能体开箱即用，零额外配置就能操作飞书。

2. 结构化输出契约：默认 --format json，成功/失败用不同通道返回——成功走 stdout、退出码 0；错误走 stderr、非零退出码。判断成功看 ok == true 或退出码，而不是去解析 code 字段。这让智能体判断「到底成没成」极其可靠。

3. 内置安全默认值：输入注入防护、终端输出清洗、凭据存系统钥匙串、请求前可用 --dry-run 预览副作用。给 Agent 用的时候，这些默认保护非常重要——毕竟 Agent 是在你的用户身份下操作。

4. 自动分页：--max-pages 控制页数，不用自己写翻页循环。

六、典型落地场景

• 日程助理：让智能体每天早上查你的 agenda、约会议、找空闲会议室；
• 消息自动化：定时把日报/告警发到群里（配合飞书卡片效果更佳，见文末相关文章）；
• 文档流水线：自动创建周报文档、读写多维表格、汇总审批；
• 会议纪要：会议结束后自动拉取纪要、生成结构化总结。

我自己最常用的是触发 IM 消息——把「给某人/某群发条消息」这件事从「打开 App 找聊天窗口」变成一行命令，交给脚本或智能体执行，省掉了大量重复操作。

七、安全提醒（用之前必读）

lark-cli 会让 AI Agent 在你的用户身份下、在授权范围内操作飞书，权限放大风险是真实存在的：

• 别把它接进公开群聊或让不可信的人/机器人交互——建议只作为私人的对话助理使用；
• 默认安全设置（注入防护、风控信号）别随意关；
• 授权范围遵循最小化原则，需要什么开什么，用完可以 lark-cli auth logout 清理。

八、参考资料

• GitHub: larksuite/cli
• 飞书 CLI 官网
• 飞书开放平台文档（AI Agent 想拉原始 Markdown，在文档 URL 后加 .md 即可）

总结

lark-cli 是飞书官方把「开放平台能力」做成人机都能用的工具：三层命令架构让你从快捷到全能平滑过渡，24+ 现成 Agent Skills + 结构化输出让它成为智能体操作飞书的最短路径。三步装完就能用，安全默认值也做得足够克制。

如果你已经在用飞书做自动化，它值得放进工具箱——配合卡片和 SDK 接入，一个人就能把飞书工作台变成「会说会做」的自动化平台。

相关文章：

• 飞书卡片入门：是什么、有什么用、怎么让智能体帮你做一张——lark-cli 发消息，卡片负责好看，俩是绝配
• 飞书 SDK 使用避坑指南：从 TenantAccessToken 到事件订阅的 20 个问题——不想用 CLI、要自己接 SDK 时的避坑手册
• Hermes Agent 升级后飞书机器人无响应：根因与修复——飞书机器人接入的真实踩坑记录