飞书开源 CLI 工具 lark-cli：200+ 命令与 19 个 AI Agent Skills 全解析
lark-cli（larksuite/cli）是飞书官方开源的命令行工具，由 larksuite 团队维护，MIT 协议。它覆盖消息、文档、多维表格、电子表格、日历、邮箱、任务、会议等 11 大业务域，提供 200+ 条命令和 19 个内置 AI Agent Skills，让开发者和 AI Agent 都能在终端中直接操控飞书。
lark-cli（larksuite/cli）是飞书官方开源的命令行工具，由 larksuite 团队维护，MIT 协议。它覆盖消息、文档、多维表格、电子表格、日历、邮箱、任务、会议等 11 大业务域，提供 200+ 条命令和 19 个内置 AI Agent Skills，让开发者和 AI Agent 都能在终端中直接操控飞书。
lark-cli 是什么
lark-cli 是飞书官方出品的开源 CLI 工具，同时服务人类用户和 AI Agent。
与第三方飞书 SDK 或非官方封装不同，lark-cli 直接由 larksuite 官方团队维护，命令与飞书开放平台 API 保持同步更新。它的核心设计理念是三层调用架构，覆盖从快速操作到完整 API 的所有粒度。
三个核心数字：
- 11 大业务域：日历、即时通讯、云文档、云空间、多维表格、电子表格、任务、知识库、通讯录、邮箱、视频会议
- 200+ 条命令：经过 Agent 实测筛选，参数设计对 AI 调用友好
- 19 个 Agent Skills：开箱即用，兼容 Claude Code、Cursor、Gemini CLI 等主流 AI 工具
三层命令架构详解
lark-cli 的命令系统分三层，按操作粒度从粗到细：
| 层级 | 前缀/形式 | 设计目标 | 示例 |
|---|---|---|---|
| 快捷命令（Shortcuts） | + 前缀 |
人机友好，智能默认值，表格输出 | lark-cli calendar +agenda |
| API 命令 | <服务> <资源> <方法> |
1:1 映射平台端点，100+ 精选命令 | lark-cli calendar calendars list |
| 通用调用（Raw API） | lark-cli api <METHOD> <path> |
覆盖全部 2500+ API | lark-cli api GET /open-apis/calendar/v4/calendars |
快捷命令是日常使用的主力，+ 前缀设计让 AI 模型可以轻松识别并调用；通用调用则是"保底"——飞书开放平台的任意接口都可以直接调用，无需等待 CLI 更新。
安装与快速上手（3 分钟）
环境要求
- Node.（提供
npm/npx） - Go v1.23+（仅从源码构建时需要）
安装
# 安装 CLI 主体
npm install -g @larksuite/cli
# 安装 CLI Skills（必须）
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 "Hello"
# 创建文档
lark-cli docs +create --title "周报" --markdown "# 进展\n- 完成功能 X"
19 个 AI Agent Skills 清单
lark-cli 最大的亮点之一是内置 19 个 AgentSkills 格式的技能，安装后可直接在 Claude Code、Cursor、Gemini CLI 等工具中调用：
| Skill 名称 | 覆盖功能 |
|---|---|
lark-shared |
应用配置、登录授权、身份切换、权限管理（被所有其他 skill 自动加载） |
lark-calendar |
日历事件、日程查看、忙闲查询、时间建议 |
lark-im |
发送/回复消息、群聊管理、消息搜索、图片/文件上传下载 |
lark-doc |
创建/读取/更新/搜索文档（基于 Markdown） |
lark-drive |
文件上传下载、权限管理、评论 |
lark-sheets |
电子表格创建、读写、追加、查找、导出 |
lark-base |
多维表格、字段、记录、视图、仪表盘、数据聚合分析 |
lark-task |
任务、子任务、清单、提醒、成员分配 |
lark-mail |
邮件浏览/搜索/收发/草稿、监听新邮件 |
lark-contact |
按姓名/邮箱/手机号搜索用户 |
lark-wiki |
知识空间、节点、文档管理 |
lark-event |
实时事件订阅（WebSocket），正则路由 |
lark-vc |
会议记录搜索、会议纪要查询 |
lark-whiteboard |
白板/图表 DSL 渲染 |
lark-minutes |
会议纪要元数据及 AI 摘要、待办、章节 |
lark-openapi-explorer |
从官方文档探索底层 API |
lark-skill-maker |
自定义 Skill 创建框架 |
lark-workflow-meeting-summary |
工作流：会议纪要聚合与结构化报告 |
lark-workflow-standup-report |
工作流：日程与待办汇总 |
lark-shared 是基础 skill，会被其他所有 skill 自动加载，无需手动引用。
在 Claude Code 中直接操控飞书
安装 lark-cli 并配置好 Skills 后，在 Claude Code 会话中可以用自然语言触发飞书操作：
# 示例：让 Claude Code 发送每日站会提醒
把今天的待办任务汇总后发到飞书群 oc_xxx
# 示例：自动创建会议纪要文档
把刚才的会议录音转写成文档，保存到飞书知识库"产品设计"空间
Claude Code 会自动匹配 lark-im、lark-task、lark-doc 等对应 Skill，调用底层命令完成操作。
AI Agent 安装流程（Claude Code 可直接执行）：
# 第 1 步：安装
npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g
# 第 2 步：配置凭证（后台运行，输出授权 URL 给用户在浏览器完成）
lark-cli config init --new
# 第 3 步：登录
lark-cli auth login --recommend
# 第 4 步：验证
lark-cli auth status
进阶用法
多格式输出
--format on # 完整 JSON（默认）
--format pretty # 人类友好格式
--format table # 表格视图
--format ndon # 换行分隔 JSON（适合管道处理）
--format csv # CSV 格式
自动分页
--page-all # 自动翻页获取全部数据
--page-limit 5 # 最多 5 页
--page-delay 500 # 每页间隔 500ms
Dry-Run 预览
对有副作用的操作（发送消息、创建文档等），先用 --dry-run 预览请求内容，确认无误再执行：
lark-cli im +messages-send --chat-id oc_xxx --text "hello" --dry-run
身份切换
同一环境中以不同身份执行命令：
lark-cli calendar +agenda --as user # 以用户身份
lark-cli im +messages-send --as bot --chat-id "oc_xxx" --text "Hello" # 以机器人身份
Schema 自省
查看任意 API 方法的参数、请求体、响应结构、支持的身份和权限范围：
lark-cli schema
lark-cli schema calendar.events.instance_view
lark-cli schema im.messages.delete
安全风险说明
lark-cli 官方在 README 中单独列出安全警告，使用前必须了解：
- AI Agent 调用此工具时，以用户授权的身份在飞书平台执行操作，可能导致敏感数据泄露或意外操作
- 不要将关联的飞书机器人加入群聊，或允许其他用户与之交互，防止权限滥用
- 凭证通过 OS 原生密钥链存储，内置输入防注入和终端输出净化
建议用最小权限原则配置 OAuth 授权范围（--scope 参数指定具体权限），不要无差别授权。
常见问题
Q：lark-cli 和飞书官方 MCP Server 有什么区别？
lark-cli 是命令行工具，通过 AgentSkills 格式与 AI 集成；MCP Server 是基于 Model Context Protocol 的服务进程，通过 JSON-RPC 与 AI 通信。两者定位互补：lark-cli 更轻量、开箱即用、无需常驻进程；MCP Server 适合需要实时事件订阅或更复杂状态管理的场景。lark-cli 也内置了 lark-event skill，支持 WebSocket 实时事件。
Q：Skills 和 CLI 命令是什么关系？
CLI 命令是底层执行单元，Skills 是告诉 AI Agent"何时调用哪些命令"的操作说明书。安装 Skills（npx skills add larksuite/cli -y -g）之后，AI 才能通过自然语言匹配并调用正确的 CLI 命令；不安装 Skills 也可以手动执行 CLI 命令，只是无法自动化。
Q：需要飞书管理员权限才能使用吗？
不需要。lark-cli 使用飞书开放平台的 OAuth 授权，以普通用户身份登录即可使用个人权限范围内的功能。企业应用场景（如批量操作用户数据）需要管理员审批相应权限。
Q：命令执行失败，提示权限不足怎么办？
用 lark-cli auth check --scope "<权限名>" 确认当前授权范围，再用 lark-cli auth login --scope "<权限名>" 补充授权。lark-cli schema <命令> 可查看该命令所需的具体权限。
Q：lark-cli 支持 Lark（国际版）和飞书（国内版）吗？
支持。lark-cli config init 配置时可选择域区（国内版/国际版），二者使用相同的命令集，无需分别安装。
结语
lark-cli 将飞书开放平台的 2500+ API 系统性地整理为 200+ 精选命令和 19 个 Agent Skills，填补了飞书生态在"可被 AI Agent 直接调用"方面的空白。对于需要将飞书深度融入 AI 工作流的开发者，这是目前覆盖最广、官方维护、开箱即用的选择。
在 AI 工作流中调用飞书 API 时，如果需要同时接入 Claude、GPT 等多模型进行任务分配，可以通过七牛云 AI 统一接入，兼容 OpenAI/Anthropic 双接口，模型切换无需修改调用逻辑。
本文基于 larksuite/cli 仓库 README（2026 年 4 月版），建议结合官方仓库获取最新命令列表。
浙公网安备 33010602011771号