一、CLI 是什么？为啥我需要 CLI？
CLI（Command Line Interface）是命令行界面。飞书 CLI 把飞书开放平台的 2500+ API 封装成 200+ 条简洁命令，并附带 24 个开箱即用的 AI Agent Skill。这意味着你的 Agent 不需要自己拼 HTTP 请求、处理鉴权、解析复杂返回值——直接调用命令就能操作飞书。
核心价值就一个：让 Agent 从"只能看"变成"能做"。 以前 Agent 只能帮你写段代码、总结篇文章；现在它能直接在你的飞书里发消息、建文档、审批流程、安排会议。
二、过去一个月的新玩法
飞书 CLI 开源后的一个月里，能力覆盖了从基础消息收发到复杂工作流编排的完整链路。以下是本次更新的八大能力板块：
三、多 Agent 在飞书里互相协作
这是本次更新最亮眼的功能——Bot@Bot。
多个 Agent 可以在飞书里互相发消息、互相协作完成任务。比如一个 Agent 负责从多维表格里拉数据，另一个 Agent 负责生成报告文档，再一个 Agent 负责把结果发到群里。整个流程不需要人工介入。
典型场景：
- 数据流水线：Agent A 从 Base 拉取销售数据 → Agent B 用幻灯片 Skill 生成 PPT → Agent C 把 PPT 发到部门群
- 审批流：Agent 检测审批请求 → 自动转发给对应审批人 → 审批完成后自动更新任务状态
- 客服工单：Agent 接收用户消息 → 查询知识库 → 自动生成回复 → 无法解决时转人工
四、Agent 在飞书里像人一样收发消息，帮你处理杂活
Agent 现在可以 полноценно 操作飞书消息系统：
| 能力 | 说明 |
|---|---|
| 收发消息 | 发送文本、图片、文件消息，回复消息，撤回消息 |
| 群聊管理 | 创建群聊、添加/移除成员、设置群名称和公告 |
| 消息搜索 | 按关键词、发送人、时间范围搜索历史消息 |
| 消息线程 | 查看和回复消息线程（Thread） |
| 媒体处理 | 上传/下载图片和文件，添加消息表情回应 |
| 身份切换 | 以用户身份或机器人身份发送消息（--as user / --as bot） |
五、Agent 直接出活儿——文档、PPT、表格、画板
这是本次更新的重头戏，Agent 可以直接创建和编辑飞书的各类文档内容：
云文档
创建、读取、更新、搜索文档，读写媒体和白板内容。支持 Markdown 格式的文档创建和覆盖写入。
画板
新增 lark-whiteboard Skill，支持白板/图表 DSL 渲染。Agent 可以生成流程图、架构图、时序图等可视化内容，直接输出到飞书画板。
幻灯片
创建和管理演示文稿，读取幻灯片内容，添加或删除幻灯片页面。适合自动生成周报、项目汇报等 PPT。
多维表格
覆盖完整的多维表格能力：创建和管理表格、字段、记录、视图、仪表盘、工作流、表单、角色与权限、数据聚合与分析。
电子表格
创建、读取、写入、追加、查找和导出电子表格数据。适合数据分析和报表生成。
云空间
上传和下载文件，搜索文档和维基，管理评论。Agent 可以帮你整理云盘文件结构。
知识库
创建和管理知识空间、节点和文档。配合 lark-wiki Skill，Agent 可以自动维护和更新团队知识库。
六、Agent 帮你开会——从参会到纪要到任务，开完会事就办了
妙记 / 视频会议
| 能力 | 说明 |
|---|---|
| 搜索会议记录 | 按关键词、时间范围搜索历史会议 |
| 查询会议纪要 | 获取会议总结、待办事项、完整转录文本 |
| 上传音视频 | 上传音频/视频文件自动创建妙记 |
| 下载媒体 | 下载会议录音和转录文件 |
| AI 纪要 | 获取 AI 生成的会议摘要、章节划分和待办清单 |
日历
查看、创建和更新日程，邀请参会人，查找会议室，回复邀请，查看空闲/忙碌时间和时间建议。
工作流组合
新增两个工作流 Skill：
lark-workflow-meeting-summary：会议纪要聚合与结构化报告lark-workflow-standup-report：日程与待办汇总报告（站会场景）
七、Agent 管你的日常——邮件、审批、任务、OKR、考勤，不用打开 App
邮件
浏览、搜索、阅读邮件，发送、回复、转发邮件，管理草稿，订阅新邮件通知。
审批
查询审批任务，批准/拒绝/转交任务，取消和抄送实例。Agent 可以帮你自动处理日常审批流程。
任务
创建、查询、更新和完成任务，管理任务列表、子任务、评论和提醒，分配成员。
OKR
查询、创建、更新 OKR，管理目标和关键结果、对齐关系、指标和进度。
考勤
查询个人考勤打卡记录。
八、Agent 帮你找东西
新增 lark-openapi-explorer Skill，可以从官方文档探索底层 API。配合飞书全局搜索能力，Agent 可以帮你：
- 在飞书内搜索文档、消息、联系人
- 通过 API 探索器找到需要的接口和参数
- 跨业务域检索信息
九、Agent 接入飞书——一行命令，17 个业务域全部就绪
飞书 CLI 覆盖了 17 个业务域，200+ 条精选命令，24 个 AI Agent Skill。以下是完整能力清单：
| 业务域 | Skill 名称 | 核心能力 |
|---|---|---|
| 日历 | lark-calendar |
日程管理、空闲查询、会议室查找、RSVP |
| 消息 | lark-im |
收发消息、群聊管理、消息搜索、媒体上传下载 |
| 文档 | lark-doc |
创建、读取、更新、搜索文档（Markdown） |
| 云盘 | lark-drive |
文件上传下载、权限管理、评论管理 |
| Markdown | lark-markdown |
创建、获取、覆盖写入 Drive 原生 Markdown 文件 |
| 电子表格 | lark-sheets |
创建、读写、追加、查找、导出表格数据 |
| 幻灯片 | lark-slides |
创建管理演示文稿、读取内容、增删幻灯片 |
| 多维表格 | lark-base |
表格、字段、记录、视图、仪表盘、工作流、表单 |
| 任务 | lark-task |
任务 CRUD、子任务、提醒、成员分配 |
| 邮件 | lark-mail |
浏览、搜索、收发、转发、草稿管理、新邮件订阅 |
| 通讯录 | lark-contact |
按姓名/邮箱/手机号搜索用户、获取用户资料 |
| 知识库 | lark-wiki |
知识空间、节点、文档管理 |
| 事件订阅 | lark-event |
实时事件订阅（WebSocket）、正则路由 |
| 视频会议 | lark-vc |
搜索会议记录、查询会议纪要（摘要、待办、转录） |
| 画板 | lark-whiteboard |
白板/图表 DSL 渲染 |
| 妙记 | lark-minutes |
妙记元数据与 AI 产物（摘要、待办、章节） |
| API 探索器 | lark-openapi-explorer |
从官方文档探索底层 API |
| Skill 制作器 | lark-skill-maker |
自定义 Skill 创建框架 |
| 考勤 | lark-attendance |
查询个人考勤打卡记录 |
| 审批 | lark-approval |
查询审批任务、批准/拒绝/转交、取消和抄送 |
| 会议纪要工作流 | lark-workflow-meeting-summary |
会议纪要聚合与结构化报告 |
| 站会报告工作流 | lark-workflow-standup-report |
日程与待办汇总报告 |
| OKR | lark-okr |
查询、创建、更新 OKR，管理目标和关键结果 |
| 共享基础 | lark-shared |
应用配置、鉴权登录、身份切换、权限管理（所有 Skill 自动加载） |
三层命令架构
飞书 CLI 提供三种粒度，从快捷操作到完全自定义 API 调用全覆盖：
1. Shortcuts（快捷命令）——以 + 开头，对人类和 AI 都友好，带智能默认值、表格输出和 dry-run 预览：
lark-cli calendar +agenda lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello" lark-cli docs +create --doc-format markdown --content "# 周报" 2. API Commands（API 命令）——从飞书 OAPI 元数据自动生成，100+ 命令与平台接口一一映射：
lark-cli calendar calendars list lark-cli calendar events instance_view --params '{"calendar_id":"primary"}' 3. Raw API（原始 API）——直接调用任何飞书开放平台接口，覆盖 2500+ API：
lark-cli api GET /open-apis/calendar/v4/calendars lark-cli api POST /open-apis/im/v1/messages --params '{"receive_id_type":"chat_id"}' 十、Agent 在飞书里做事，安全有兜底
通过开源 CLI 直接可用
CLI 默认开启多层安全保护：
- 输入注入保护——防止提示词注入攻击
- 终端输出消毒——敏感信息自动脱敏
- OS 原生密钥链存储——凭证不存明文
- Dry-run 预览——有风险的操作可以先预览再执行
- Schema 自省——执行前检查命令参数、请求体、响应结构
飞书平台侧的安全与治理
飞书开放平台提供完整的权限管控和审计能力。管理员可以在飞书管理后台设置应用权限范围、审批流程和操作审计日志。
️ 重要提醒：AI Agent 调用存在模型幻觉、执行不可控、提示词注入等固有风险。授权飞书权限后，Agent 会以你的身份在授权范围内操作，可能导致敏感数据泄露或未授权操作。建议将飞书 Bot 作为私人对话助手使用，不要加入群聊或让其他用户交互。
十一、立即体验
安装
# 安装 CLI npm install -g @larksuite/cli # 安装 CLI SKILL（必需） npx skills add larksuite/cli -y -g 配置
# 配置应用凭证（交互式引导） lark-cli config init # 登录（--recommend 自动选择常用权限） lark-cli auth login --recommend # 验证 lark-cli auth status 开始使用
# 查看今日日程 lark-cli calendar +agenda # 发送消息 lark-cli im +messages-send --chat-id "oc_xxx" --text "今天周报已更新" # 创建文档 lark-cli docs +create --doc-format markdown --content "# 项目周报
## 本周进展
- 完成功能 A
- 修复 Bug B" # 生成会议纪要 lark-cli minutes +list --limit 5 AI Agent 快速接入
如果你在用 Claude Code、Cursor、Trae 等 AI 编程助手，只需一行命令即可让 Agent 获得飞书操作能力。安装后 Agent 会自动加载对应的 Skill，无需额外配置。