主题
飞书 CLI
飞书 CLI 是 larksuite 团队维护的飞书 / Lark 命令行工具,用于在终端和 AI Agent 中操作飞书开放平台能力。
适用场景
- 查询或整理飞书日程、任务、会议纪要和 OKR。
- 读取、创建、更新或搜索飞书文档、知识库、多维表格和电子表格。
- 发送消息、回复消息、管理群聊、搜索消息或下载媒体文件。
- 让 Agent 基于飞书上下文生成周报、站会摘要、会议纪要汇总或待办清单。
- 需要直接调用飞书开放平台 API,但不想为每个接口单独写 SDK 脚本。
能力范围
| 类别 | 能力 |
|---|---|
| 协作沟通 | 消息、群聊、聊天记录、话题、媒体文件 |
| 内容与知识 | 云文档、云空间、Markdown、知识库、幻灯片 |
| 数据协作 | 多维表格、电子表格、字段、记录、视图、仪表盘 |
| 日常办公 | 日历、任务、邮箱、会议、考勤、审批、OKR |
| 平台能力 | 应用开发、通用 API 调用、schema 自省、分页和多格式输出 |
安装与登录
推荐通过 npm / npx 安装:
bash
npx @larksuite/cli@latest install源码构建需要 Go v1.23+ 和 Python 3:
bash
git clone https://github.com/larksuite/cli.git
cd cli
make install
npx skills add larksuite/cli -y -g首次使用通常需要先配置应用凭证,再登录授权:
bash
lark-cli config init
lark-cli auth login --recommend
lark-cli auth statusAgent 使用方式
飞书 CLI 提供一组面向 Agent 的 Skills,覆盖日历、消息、文档、云空间、多维表格、任务、邮箱、通讯录、知识库、事件、会议、妙记、审批、OKR 等方向。
Agent 配置时建议采用以下流程:
- 先安装 CLI 和 Skills。
- 由用户在浏览器中完成应用配置和 OAuth 登录。
- 用
lark-cli auth status确认登录状态。 - 只给当前任务需要的业务域和权限。
- 写操作先使用 dry-run 或让 Agent 输出计划。
命令层级
飞书 CLI 提供三种调用粒度:
| 层级 | 说明 | 示例 |
|---|---|---|
| 快捷命令 | 以 + 开头,面向常见任务封装,适合人类和 Agent | lark-cli calendar +agenda |
| API 命令 | 与平台端点对应,适合稳定自动化脚本 | lark-cli calendar calendars list |
| 通用 API | 直接调用开放平台端点,适合临时或长尾接口 | lark-cli api GET /open-apis/calendar/v4/calendars |
常用能力
bash
lark-cli calendar +agenda
lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"
lark-cli auth login --recommend
lark-cli auth check --scope "calendar:calendar:read"
lark-cli schema calendar.events.instance_view输出格式可按场景切换:
bash
--format json
--format pretty
--format table
--format ndjson
--format csv分页和预览建议用于批量读取或高风险写操作:
bash
--page-all
--page-limit 5
--dry-run安全建议
- 不要给 Agent 授权超过当前任务所需的 scope。
- 涉及消息发送、文档修改、审批操作或任务创建时,先让 Agent 说明目标、参数和影响范围。
- 私人机器人不要拉入群聊,避免其他成员间接触发高权限操作。
- 不要关闭默认安全保护,包括输入防注入、输出净化和系统密钥链凭证存储。
- 生产环境自动化任务优先使用受控应用,避免长期复用个人全权限账号。
提示词示例
text
请使用飞书 CLI 只读查询今天的日程和未完成任务,
整理为一份站会摘要。
不要发送消息、创建任务或修改任何文档。text
请先 dry-run 预览要发送的飞书消息,
列出 chat_id、消息内容和风险点。
等待我确认后再执行真实发送。