使用 Lark CLI 自动化飞书办公

Lark CLI 是飞书/Lark 官方维护的命令行工具，面向开发者和 AI Agent。安装后，Codex、Claude Code 等终端智能体可以通过自然语言调用飞书的日历、消息、文档、表格、任务和会议等能力。

CLI、Skills 和 AI Agent 的关系

可以把整套方案理解为三层：

1. Lark CLI：把飞书 API 封装成相对简洁的终端命令。
2. Skills：告诉 AI 在什么场景使用哪些命令、参数如何填写。
3. AI Agent：理解自然语言、读取 Skill，并组合命令完成任务。

CLI 负责“能操作”，Skills 负责“知道怎么操作”，AI Agent 负责理解你的目标并执行。

安装 Lark CLI

可以把官方仓库或安装文档交给 Codex，让它协助完成安装。当前官方快速开始命令为：

npx @larksuite/cli@latest install

接着初始化应用配置：

lark-cli config init --new

命令会提供授权地址。根据提示在浏览器中完成配置后，再登录：

lark-cli auth login --recommend

最后检查状态：

lark-cli auth status

安装方式和命令可能随版本更新，遇到差异时以官方 README 为准。

验证安装

第一次使用先执行只读任务：

查看我今天的日程，按时间顺序整理。
不要创建、修改或删除任何日程。

AI 会先读取日历 Skill，再调用对应的 Lark CLI 命令。确认只读功能正常后，再尝试创建内容。

创建日程

在我的主日历创建一个日程：
标题：项目进度同步
时间：明天上午 11:00 到 11:30
创建前先把最终信息展示给我确认。

把时区、日期、开始和结束时间写清楚，并在创建后检查飞书日历。

发送消息

在“产品群”发送消息：
“明天上午 11 点同步项目进度，请提前更新任务状态。”
发送前先展示群聊和完整消息内容，等待我确认。

需要注意：某些消息能力可能以 Bot 身份发送，不一定能冒充当前用户本人。具体可用身份取决于飞书应用权限和当前 CLI 能力。

创建文档和表格

Lark CLI 还可以让 AI 把整理结果写入飞书：

整理今天最重要的 5 条 AI 新闻。
每条包含标题、摘要、来源和发布日期。
创建一篇飞书文档，写入整理结果。
创建前先把文档结构展示给我。

表格示例：

收集三款 AI 编程工具的公开价格信息。
创建飞书电子表格，列为产品、方案、价格、计费周期、来源链接和查询日期。
无法核实的数据留空，不要猜测。

为什么 CLI 适合 AI Agent

传统 API 往往需要较长的参数结构和额外代码。CLI 对常见操作进行了封装，命令更短，AI 组合和排错更容易，返回内容也通常更适合继续处理。

官方工具当前覆盖 200 多条命令和多项 Agent Skills，涉及消息、文档、云空间、多维表格、电子表格、日历、邮件、任务和会议等领域。

当前限制

• 某些消息只能以 Bot 身份发送。
• 主动发消息给 Bot，不一定会自动触发本地 AI Agent。
• 权限不足时需要重新配置飞书应用 Scope。
• 涉及他人、群聊和共享文档时要避免误发或误改。
• 工具仍在更新，命令和能力以当前官方文档为准。

安全建议

• 第一次使用从读取日程等只读任务开始。
• 创建、发送、覆盖和删除前保留确认步骤。
• 只申请完成任务所需的最小权限。
• 不要把应用凭据、令牌或密钥写进课程文档和公开仓库。
• 重要文档和表格完成后，在飞书中人工复核。

本节练习

完成 Lark CLI 安装与登录，先读取今天的日程。验证成功后，创建一个 5 分钟后的测试日程，并在检查无误后删除。

本节小结

• Lark CLI 把飞书 API 封装成适合终端和 AI Agent 的命令。
• Skills 告诉 AI 何时以及如何调用这些命令。
• 可以操作日历、消息、文档、表格和其他办公数据。
• 消息身份、双向触发和权限范围仍有限制。
• 写入、发送和删除操作必须保留人工确认。

官方资料：Lark CLI GitHub · 飞书开放平台安装指南