# 6000 Stars的飞书CLI到底能干嘛？我用Claude Code接了一遍
**作者**: Jason Zhu
**日期**: 2026-04-02T07:22:29.000Z
**来源**: [https://x.com/GoSailGlobal/status/2039604367880528033](https://x.com/GoSailGlobal/status/2039604367880528033)
---
飞书开源了一个 CLI 工具，6000+ stars，200 多条命令，19 个预置 Agent Skills。你用 Claude Code 说一句"帮我查下明天的日程"，它自己调飞书 API 把结果给你。不用写代码，不用配 webhook，四行命令装好就能用
## AI 时代为什么 CLI 比 API 好用
飞书开放平台有 2500 多个 API。传统做法是写代码调 SDK，处理鉴权、分页、错误重试。对开发者来说不难，对 AI Agent 来说太重了
CLI 解决了这个问题。AI 天然擅长处理文本输入输出，一条命令就是一个完整的操作单元。不需要理解 SDK 的类型系统，不需要处理 HTTP 状态码，lark-cli calendar +agenda 一行搞定查日程
飞书官方的设计理念就一句话：GUI 面向普通用户，CLI 面向开发者和 AI Agent。在 Agent 时代，接口从 GUI 回归 CLI 反而更顺手
## 三层命令架构：从一键到裸调
这套 CLI 不是简单的 API 封装，设计了三层命令体系，越往下越底层
第一层 Shortcuts（+ 前缀） 是给人和 AI 用的高级命令，带智能默认值。+agenda 自动查当天日程，+messages-send 直接发消息，不需要手动拼参数
> lark-cli calendar +agenda
> lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"
> lark-cli vc +search --start "2026-03-01" --end "2026-03-31"
第二层 API Commands 是从飞书 OAPI 元数据自动生成的 100 多条命令，覆盖日历、文档、表格、消息等 11 个业务域
> lark-cli calendar calendars list
> lark-cli calendar events instance_view --params '{"calendar_id":"primary"}'
第三层 Raw API 是裸调。飞书 2500 多个 API，前两层没覆盖的直接用 api 命令访问
> lark-cli api GET /open-apis/calendar/v4/calendars
> lark-cli api POST /open-apis/vc/v1/rooms/search --data '{"query":"5F"}'
优先级：Shortcut > 已注册 API > api 裸调。日常用第一层就够了，需要精细控制才往下走
## 19 个 Agent Skills 分类解读
19 个 Skills 不是一股脑装上去的。按功能可以分成四类
基础设施类
lark-shared 是所有 Skill 的底座，负责应用配置、认证登录、身份切换、权限管理。其他 18 个 Skill 都依赖它
lark-openapi-explorer 是 API 探索器。当现有命令满足不了需求时，它会从飞书官方的 llms.txt 文档库里逐层挖掘原生接口
lark-skill-maker 让你自己造 Skill。把常用的飞书操作封装成 SKILL.md，下次直接复用
日常办公类
lark-calendar 查日程、建会议、查空闲、推荐最佳开会时间。lark-im 收发消息、建群、管群。lark-mail 看邮件、搜邮件、回邮件，还能 +watch 实时监听新邮件。lark-task 管任务和待办。lark-contact 按名字、邮箱、手机号查人
文档数据类
lark-doc 创建和编辑云文档，支持 Markdown 输入输出。lark-sheets 操作电子表格。lark-base 操作多维表格，支持字段、记录、视图的完整 CRUD。lark-drive 管理云空间文件。lark-wiki 管理知识库
高级场景类
lark-event 通过 WebSocket 长连接实时监听飞书事件，输出 NDJSON 格式，支持正则路由匹配。lark-vc 搜会议记录、查会议纪要和 AI 摘要。lark-minutes 获取会议录制和 AI 纪要。lark-whiteboard 操作白板和图表
两个工作流 Skill 做的事更完整：lark-workflow-meeting-summary 自动汇总指定时间范围的会议纪要生成报告，lark-workflow-standup-report 编排日历和任务数据生成每日站会报告
## 三种 AI 工具的接法
飞书 CLI 能接三种主流 AI 工具，每种接法适合不同场景
Claude Code 装好 Skills 后，Claude Code 自动识别飞书相关指令，直接调 lark-cli 执行。你说"帮我把这个会议纪要发给张三"，它自己拆成查会议记录、提取纪要、查联系人、发消息四步完成
Cursor 不支持直接命令行执行，需要走 MCP 协议。飞书提供了 @larksuiteoapi/lark-mcp npm 包，装上之后 Cursor 能调飞书接口
OpenClaw 有飞书官方的 openclaw-lark 插件，支持消息读写、文档管理、表格操作、日历任务，还能做交互式消息卡片和流式文本响应
三种方式的定位不一样。CLI 是执行层，支持 Unix 管道组合操作，轻量不占上下文。MCP 是把工具清单预注册到 AI 上下文窗口，适合 Cursor 这种非终端环境。Skills 提供使用说明和最佳实践，提高 AI 操作成功率
## 实战场景
用 Claude Code 一分钟向 24 个联系人发送个性化消息，AI 读取名单逐条定制内容，im +messages-send 逐个发出
多维表格的数据也能玩。base 命令把飞书多维表格数据拉到本地，AI 写前端代码渲染成交互式可视化 Dashboard 网页
会后自动化是最省时间的场景。从会议纪要提取待办，doc +create 建文档，task 建任务分配到人，im +messages-send 群发通知。会议结束三分钟内所有人收到各自的待办
MCN 项目管理表里经常有缺失字段，AI 用 base 命令扫描所有记录，找出缺失数据生成修复建议。收到大量简历邮件，mail 命令批量读取，AI 提取关键信息写入多维表格，形成结构化候选人数据库
lark-event +subscribe 能做实时监控。监听消息事件，AI 汇总分析，每天定时生成热点摘要发到指定群，10 分钟就搭起来了
跨时区开会最头疼排时间。AI 用 calendar +agenda 查各人日程算时差，推荐最佳会议时间段，一键建会发邀请
## 怎么装
Node.js 16 以上环境就行
> # 第一步：安装 CLI
> npm install -g @larksuite/cli
> # 第二步：配置应用凭证（交互式，会生成授权链接）
> lark-cli config init --new
> # 第三步：登录授权（OAuth 扫码）
> lark-cli auth login --recommend
> # 第四步：安装 Agent Skills
> npx skills add larksuite/cli -y -g
验证安装：lark-cli --version，然后跑一个 lark-cli calendar +agenda 看看能不能拿到今天的日程
认证有两种身份：--as user 用用户身份访问自己的日历、文档、邮箱；--as bot 用应用身份做应用级操作。初学者最常犯的错就是用 bot 身份去查用户日历，结果什么都查不到
## 踩坑提醒
安全方面飞书官方说得很直白：AI Agent 操控飞书存在固有风险。模型幻觉可能导致错误操作，prompt 注入可能被利用，授权后 Agent 以你的身份行动。建议仅作为个人助理使用，不要把 bot 加到群聊里
几个技术细节容易踩坑
vc +search 搜会议记录最大范围只有一个月，更长时间需要分批查询。task +get-my-tasks 不加过滤可能返回 30 多条数据超过 100KB，容易撑爆 AI 的上下文窗口。日期参数只支持 ISO 8601 格式，写 "tomorrow" 是不行的
权限是两层机制：开发者后台要开通对应的 scope，用户还要 auth login 授权。两层都满足了才能用。权限是增量累积的，多次 auth login 的 scope 会叠加，不用担心覆盖
项目目前有 129 个 open issues，迭代很快，每天都有新 commit。功能还在快速完善中，遇到问题可以去 GitHub 提 issue
飞书 CLI 开源地址：github.com/larksuite/cli
OpenClaw 飞书插件：github.com/larksuite/openclaw-lark
## 相关链接
- [Jason Zhu](https://x.com/GoSailGlobal)
- [@GoSailGlobal](https://x.com/GoSailGlobal)
- [370](https://x.com/GoSailGlobal/status/2039604367880528033/analytics)
- [@larksuiteoapi/lark-mcp](https://x.com/@larksuiteoapi/lark-mcp)
- [openclaw-lark](https://github.com/larksuite/openclaw-lark)
- [@larksuite/cli](https://x.com/@larksuite/cli)
- [github.com/larksuite/cli](https://github.com/larksuite/cli)
- [github.com/larksuite/openclaw-lark](https://github.com/larksuite/openclaw-lark)
- [Upgrade to Premium](https://x.com/i/premium_sign_up)
- [3:22 PM · Apr 2, 2026](https://x.com/GoSailGlobal/status/2039604367880528033)
- [370 Views](https://x.com/GoSailGlobal/status/2039604367880528033/analytics)
---
*导出时间: 2026/4/2 16:31:02*