lark-cli — 飞书官方 CLI 工具

这是飞书官方开源的全能命令行工具,让人和 AI Agent 都能在终端里操作飞书。

200+ 命令 + 26 个 AI Agent Skill,覆盖飞书 18 个核心业务域——消息、文档、表格、日历、会议、邮箱、审批、OKR、考勤……几乎飞书的每一个功能都有对应的命令。

GiHub地址https://github.com/larksuite/cli


核心亮点

亮点 说明
为 Agent 原生设计 26 个 Skills 开箱即用,AI 无需额外适配即可操作飞书
覆盖面广 18 大业务域,从发消息到管 OKR、从多维表格到幻灯片
AI 友好 每条命令经过 Agent 实测验证,智能默认值 + 结构化输出
MIT 开源 npm install 就能用,零门槛
安全可控 输入防注入、OS 原生密钥链存凭证
三层调用 快捷命令(人友好)→ API 命令(平台同步)→ 通用调用(全 2500+ API 覆盖)

支持的场景(摘选)

  • 📅 日历:查看日程、邀参会人、查忙闲
  • 💬 即时通讯:收发消息、管理群聊、搜索聊天记录
  • 📄 云文档:创建/读写文档,支持原生 Markdown
  • 📊 多维表格 + 电子表格:CRUD、数据聚合、导出
  • 📧 邮箱:浏览、搜索、发送、回复、监听新邮件
  • 任务:创建、查询、完成任务,管理评论和提醒
  • 🎯 OKR:目标、关键结果、对齐、进展记录
  • 🎥 会议:搜索会议记录、查询纪要产物
  • ✍️ 审批:查询、同意/拒绝/转交审批任务

三层命令架构

1
2
3
快捷命令 (+)    →  lark-cli calendar +agenda          (人和 AI 最常用)
API 命令 → lark-cli calendar calendars list (100+ 精选端点)
通用 API 调用 → lark-cli api GET /open-apis/... (2500+ 全部 API)

上手三步

1
2
3
4
5
6
7
8
9
10
11
# 1. 安装
npx @larksuite/cli@latest install

# 2. 配置应用凭证(交互式引导)
lark-cli config init

# 3. 登录授权
lark-cli auth login --recommend

# 4. 开始用
lark-cli calendar +agenda

安全提示(官方强调)

这个工具可以让 AI 以你的身份操作飞书,存在数据泄露和越权风险。官方强烈建议只用作私人助手,不要拉进群聊,不要改默认安全配置。


技术栈

Go 1.23+ 编写,通过 npm 分发(@larksuite/cli),MIT 协议。