第 1 节：10 分钟让 AI Agent 接入飞书，先跑通 Lark CLI

基于 larksuite/cli 官方 README 整理：安装 lark-cli、完成授权，并跑通你的第一个飞书自动化命令。

先说结论：如果你经常想让 AI 帮你查日程、写飞书文档、发消息、读会议纪要，那 lark-cli 很值得优先学。它不是单纯的命令行工具，而是把飞书能力变成 AI Agent 能直接调用的工具层。

时效说明：本文基于 larksuite/cli 官方 README.zh.md 整理，最后核对时间为 2026-04-05。

这 10 分钟你会得到什么

装好 lark-cli
装好配套 Skill
完成一次飞书授权
跑通第一个有结果的命令
知道后面该往哪几个方向扩展

适合谁

想让 AI 助手直接操作飞书的人
经常用飞书管理日程、文档、表格、任务的人
想做个人自动化，而不是一上来就写一堆 API 代码的人

不适合谁

只想偶尔手动点点飞书网页的人
需要企业级大规模集成、准备直接上后端服务的人
对权限授权非常敏感，但暂时又没时间做权限治理的人

10 分钟速通

第 1 步：安装 CLI 和 Skill

npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g

第一条是装工具，第二条是让你的 AI 助手认识这套飞书能力。少了 Skill，很多 Agent 即使装了 CLI，也不会主动调用。

第 2 步：初始化配置

如果你是自己在终端操作：

lark-cli config init

如果你是让另一个 AI Agent 帮你安装，优先用这个：

lark-cli config init --new

它会给你一个授权链接，你在浏览器里完成配置即可。

最省事做法

自己手动装，就用 lark-cli config init。让 Agent 代装，就用 lark-cli config init --new，然后把浏览器授权这一步交给你自己完成。

第 3 步：登录并授权常用权限

lark-cli auth login --recommend

这个参数会优先帮你拿一组常用权限。对新手来说，先跑通比一开始自己抠每个 scope 更重要。

第 4 步：先确认授权真的成功了

lark-cli auth status

看到当前登录状态和已授权 scope，就说明这条链路已经通了。

第 5 步：跑第一个“有反馈”的命令

先看今天的日程：

lark-cli calendar +agenda

如果你今天没有日程，命令返回空结果也算成功。重点不是“必须查到东西”，而是你已经完成了 “AI / CLI → 飞书 → 返回结构化结果” 的闭环。

如果你想再多走一步，可以直接让它新建一篇飞书文档：

lark-cli docs +create --title "Lark CLI 测试文档" --markdown "# 今天学会了什么\n- 我已经跑通了飞书 CLI"

先别急着发消息或批量改数据

带副作用的命令先用 --dry-run 预览，请求没问题再执行。比如：lark-cli im +messages-send --chat-id oc_xxx --text "hello" --dry-run

你现在已经解锁了什么

按官方 README，这个 CLI 覆盖的能力非常广，常见的有这些：

calendar：查日程、创建会议、看忙闲
docs / drive：创建文档、搜索文档、上传下载文件
sheets / base：电子表格、多维表格
task：任务、子任务、提醒
mail：收发邮件
im：发消息、搜聊天记录
vc / minutes：会议纪要、妙记内容

也就是说，你学的不是一个孤立命令，而是在给 AI 打开一个完整的飞书工作入口。

这节课最值得抄的 3 个玩法

早上让 AI 先拉出日程，再汇总待办
这条线后面可以继续接 lark-workflow-standup-report。
会议结束后自动整理纪要和 action items
这条线后面可以接 lark-vc、lark-minutes、lark-workflow-meeting-summary。
把 AI 生成的结果直接写进飞书文档或表格
比如写周报、整理客户线索、沉淀 SOP。

它为什么比“直接调 API”更适合作为第一课

lark-cli 的核心价值，不是把飞书 API 搬到终端里，而是帮你把“授权、命令格式、输出结构、常用工作流”先封装好了。

你可以把它理解成三层：

层级	适合场景	你得到什么
快捷命令 `+`	新手、日常高频操作	最省脑，直接可用
API 命令	需要更细的控制	和平台端点更接近
通用 API 调用	极客和深度集成	几乎全量覆盖飞书开放平台

这也是为什么它很适合作为系列第一课：先跑通，再逐步深入，不需要第一天就把开放平台文档啃完。

跟另外两种做法怎么选

方案	适合谁	优点	局限
直接在飞书里手动操作	偶发需求	最直观	不能自动化，也不方便给 AI 用
直接写飞书开放平台代码	工程团队	灵活、可深度集成	上手成本高，前期容易卡在权限和接口细节
`lark-cli`	个人、创作者、AI 工作流玩家	上手快、能力广、对 Agent 友好	仍然要认真处理权限和安全边界

这条线的边界和坑点

不要一上来就给过大的权限，先从常用最小集开始
不要把它直接拉进多人群聊里当公共机器人用
不要主动关闭默认安全配置
涉及发消息、改文档、改表格这类动作，先 --dry-run
真正敏感的数据流，最好单独做权限隔离

官方给的核心提醒

授权之后，AI Agent 会在你授权范围内，以你的身份执行操作。它确实能大幅提效，但也同样可能带来误操作、越权和数据泄露风险。最稳的方式，是先把它当成“私人飞书助手”来用。

下一步怎么学

学完这一课，不要急着到处翻文档。你只要沿着下面一条线继续就行：

先把 calendar +agenda 用熟
再学一个写入动作，比如 docs +create
再挑一个工作流 skill，比如日程摘要或会议纪要汇总
最后再去看更底层的 API 命令和通用调用

延伸资源

官方中文 README: https://github.com/larksuite/cli/blob/main/README.zh.md
GitHub 仓库： https://github.com/larksuite/cli
系列入口：/docs/10min-ai-skills

第 1 节：10 分钟让 AI Agent 接入飞书，先跑通 Lark CLI

目录