飞书把整套办公能力开放给 AI 调用了。通过 lark-cli，你的 AI Agent 可以直接操作飞书：发消息、创建会议、写文档、更新表格，无需人工复制粘贴。

适合场景：使用 Claude Code、Cursor 等 AI 编程工具的开发者，以及需要自动化办公流程的团队。

开始前的准备

• 已安装 Node.js 环境
• 使用 Claude Code、Codex、Cursor 等支持工具调用的 AI 工具
• 预计时间：5-10 分钟完成安装配置

具体步骤

第一步：安装 CLI 工具

npm install -g @larksuite/cli

第二步：安装 Skills

npx skills add https://github.com/larksuite/cli -y -g

第三步：初始化配置

lark-cli config init --new

配置完成后，重启你的 AI 工具（如 Claude Code），即可通过自然语言调用飞书能力。

💡 提示: 支持两种权限模式 - 不授权模式可执行基础操作，用户身份模式可访问日历、私信等个人数据。

第四步：授权登录（可选）

如需访问个人数据，执行：

lark-cli auth login

核心功能

lark-cli 覆盖飞书 11 大业务域，提供 200+ 命令和 19 个 Agent Skills：

• 即时通讯 (lark-im): 消息发送、回复、群聊管理、搜索消息
• 云文档 (lark-doc): 文档创建、读取、更新与评论协作（支持 Markdown）
• 多维表格 (lark-base): 字段、记录、视图与仪表盘操作
• 日历 (lark-calendar): 日程查询、会议创建、闲忙查询、时间推荐
• 邮件 (lark-mail): 邮件读取、发送、回复、归档
• 任务 (lark-task): 任务创建、更新与子任务管理

实际应用场景

会议执行自动化

AI 可读取妙记内容，提取待办，并自动执行发送文档、创建会议、补充信息等操作。支持设置唤醒词，在会后自动触发执行。

文档协作

直接让 AI 创建飞书文档初稿，并根据评论持续修改。也可以让 AI 作为审稿人提出修改建议。

示例指令：

根据我的所在部门、飞书消息、飞书云文档、日程等信息，
帮我创建一篇飞书云文档，写一篇个人使用说明书。

智能约会

AI 可读取群成员日历，自动计算空闲时间和时区，推荐会议时间并完成创建。

示例指令：

帮我看一下【XX】群里所有人的日历，
然后下周找一个大家都合适的时间开一小时的讨论会。

邮件处理

AI 可扫描未读邮件，按优先级分类，将重要邮件摘要推送至群聊，并生成回复草稿。

为什么比传统 API 更适合 Agent

lark-cli 专门为 Agent 调用设计：

• 智能默认值: 命令结构更适合 AI 调用，提供结构化输出
• 错误自修复: 错误信息可指导 AI 修复，而非简单报错
• 权限引导: 权限不足时自动引导补授权
• Token 优化: 对 token 消耗进行了优化，提升调用效率

三层调用结构

• 快捷命令 (Shortcuts): 以 "+" 为前缀，适合直接调用
• API 命令: 对应飞书开放接口
• 通用 API 调用: 支持全部 2500+ 接口

支持 JSON、表格、CSV 等多种输出格式，以及分页、Dry Run 预览和 Schema 查询等能力。

常见问题

Q: 需要付费吗？ A: lark-cli 完全开源免费，但需要飞书账号。

Q: 支持哪些 AI 工具？ A: 目前支持 Claude Code、Codex、Cursor 等主流 AI 工具，OpenClaw 用户后续可通过官方插件直接使用。

Q: 数据安全吗？ A: 所有操作都通过飞书官方 API，遵循飞书的安全规范。

项目地址: https://github.com/larksuite/cli

相关资源:

• 飞书开放平台文档
• lark-cli GitHub