cli

在终端和 AI Agent 里直接操作飞书全套办公能力

飞书/Lark 官方开源的命令行工具，由 larksuite 团队维护，用 Go 编写。它把飞书生态里的核心业务能力搬到终端：消息（Messenger）、云文档（Docs）、多维表格（Base）、电子表格（Sheets）、日历（Calendar）、邮箱（Mail）、任务（Tasks）、会议（Meetings）等，提供 200 多个命令，并内置 20 多个面向 AI Agent 的 Skills。它解决的是「人不想离开终端、Agent 又需要稳定接口操作飞书」的问题：开发者可以在脚本、CI、自动化流程里直接发消息、读写文档、管理表格与日程，也能让 AI Agent 通过标准化命令完成飞书内的办公操作，减少手工点击和重复劳动。作为官方工具，接口与权限模型和飞书平台保持一致，适合把飞书当作可编程工作台来用。

开源 free 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 17235

维护状态活跃

是否开源是

定价模式 free

项目数据

分类自动化工作流

开发团队larksuite

所属国家

官网地址

GitHubhttps://github.com/larksuite/cli

定价模式free

价格说明开源免费，需自行部署使用

访问状态

是否开源是

开源协议MIT

主要语言Go

技术栈/模型

GitHub 星标★ 17235

30天Star增速

HF 下载量

上线时间2026-03-25 00:00:00

最近更新2026-09-16 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-12

浏览次数2

使用教程

难度：入门约 3 分钟部署方式：命令行工具 7 步

环境要求

Node.js/npm 环境（使用 npx 安装方式）
Go v1.23+ 与 Python 3（仅源码安装方式需要）
飞书/Lark 账号，并准备应用凭证（App ID / App Secret）
可打开浏览器完成授权登录

安装与启动步骤

1安装 CLI

推荐方式，通过 npm 一键安装官方 CLI，无需克隆仓库。
```
npx @larksuite/cli@latest install
```
2源码安装（可选）

另一种安装方式，需 Go v1.23+ 和 Python 3，编译后执行 make install。
```
git clone https://github.com/larksuite/cli.git
cd cli
make install
```
3安装 Skills

安装 CLI SKILL，官方标注为必需步骤，供 AI Agent 调用。
```
npx skills add larksuite/cli -y -g
```
4配置应用凭证

交互式引导完成一次性配置；AI Agent 场景加 --new，需在后台运行并取出授权链接交给用户。
```
lark-cli config init
```
5登录授权

完成飞书账号授权；AI Agent 场景加 --recommend，同样后台运行并提取授权 URL。
```
lark-cli auth login --recommend
```
6验证登录状态

查看当前授权状态，确认安装与授权是否成功。
```
lark-cli auth status
```
7试运行预览

对有副作用的命令先加 --dry-run 预览请求，确认无误后再真实执行。
```
lark-cli im +messages-send --chat-id oc_xxx --text "hello" --dry-run
```

关键配置

配置项	必填	说明	示例
`app credentials`	是	飞书应用凭证，由 lark-cli config init 交互式引导配置	`lark-cli config init`

如何确认成功

执行 lark-cli auth status，能正常返回当前授权状态即表示安装与登录成功。

常见问题

Q：npm 安装和源码安装该选哪个？

A：普通用户推荐 npm 方式，一条 npx 命令即可；源码方式仅在需要自行编译时使用，要求 Go v1.23+ 和 Python 3。

Q：AI Agent 安装与人工安装有何区别？

A：Agent 版流程相同，但 config init 要加 --new、auth login 要加 --recommend，并在后台运行、把授权 URL 交给用户。

Q：如何避免命令产生误操作？

A：对可能产生副作用的命令先加 --dry-run 预览请求内容，确认无误后再去掉该参数执行。

Q：安装需要多久？

A：README 说明从安装到首次 API 调用约 3 分钟，共 3 步，官方提供一键创建应用与交互式登录。

注意事项

Skills 安装被 README 标注为必需步骤，不要跳过。
凭证存储在操作系统原生钥匙串中，安全性由系统保障。
AI Agent 执行 config init 与 auth login 时需后台运行并提取授权链接发给用户。
CLI 覆盖 18 个业务域、200+ 命令与 26 个 AI Agent Skills，采用 MIT 开源协议。

核心亮点

官方维护，覆盖 Messenger、Docs、Base、Sheets、Calendar、Mail、Tasks、Meetings 等核心域，接口与飞书平台同步
200+ 命令 + 20+ AI Agent Skills，人和 Agent 都能用，适合脚本化与自动化编排
Go 编写，单二进制分发，跨平台部署和 CI 集成成本低

不足之处

功能深度依赖飞书开放平台权限与租户配置，首次接入需要申请应用和授权，门槛不低
命令数量多，文档与示例的完整度、版本兼容性需要持续跟进

适用场景

CI/CD 或运维脚本中自动发送飞书告警、更新多维表格状态
AI Agent 读取云文档、写入 Base 记录、安排日历会议，完成办公自动化
开发者用命令行批量管理群消息、任务和邮箱，减少在网页端重复点击

替代项目

lark-cli、feishu-bot、open-feishu-sdk

项目介绍

cli 是一个自动化工作流领域的开源项目，官方简介：The official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200+ commands and 20+ AI Agent Skills.。项目使用 Go 开发，在 GitHub 上获得 17134 星标。

上一篇：openwork

下一篇：BrowserSkill

cli