lark-cli（飞书官方 CLI）
lark-cli 是飞书官方维护的终端工具，让人和 AI Agent 都能在命令行里操作飞书。本后台的多项通知、对账、文档维护都依赖它。
为什么用 lark-cli 而不是直接调 API
- 覆盖面广 — 18 大业务域、200+ 命令、26 个 AI Agent Skills
- AI 友好 — 每条命令都经过 Agent 实测，参数智能、输出结构化
- 安全可控 — 输入防注入、终端输出净化、OS 原生密钥链存凭证
- 三层调用架构 — 快捷命令（人机友好）→ API 命令（平台同步）→ 通用调用（全 API 覆盖）
安装
bash
# npm（推荐）
npx @larksuite/cli@latest install
# 或全局
npm install -g @larksuite/cli安装后验证：
bash
lark-cli --version认证
bash
lark-cli auth login会引导你在浏览器里完成飞书 OAuth 授权，凭证存到 OS 密钥链。查看当前身份：
bash
lark-cli auth status本后台最常用的能力
| 场景 | lark-cli 入口 |
|---|---|
| 发飞书消息 / 通知群 / 卡片 | lark-cli im send |
| 读飞书云文档（公告、SOP） | lark-cli doc read |
| 管云盘附件 | lark-cli drive upload/download |
| 查日历 / 会议室 | lark-cli calendar |
| 查任务 / 待办 | lark-cli task |
| 飞书知识库操作 | lark-cli wiki |
| 多维表格 / 电子表格 | lark-cli base / lark-cli sheets |
具体子命令通过 lark-cli <domain> --help 查看；每个域都是独立的 Skill 目录。
AI Agent 集成
lark-cli 内置 26 个 Agent Skills，覆盖：
- 邮件、日历、即时通讯、云文档、云空间
- 多维表格、电子表格、幻灯片、任务、知识库
- 视频会议、考勤、审批、OKR、通讯录
在 Cursor / Claude Code / dsh 等 Agent 环境中直接调用：
$ lark-cli im send --user webkubor --text "明天上午 10 点对账"给企业接入方的提示
如果你要把 lark-cli 嵌进自研 Agent 平台、需要中心化凭证管理和审计：
- 阅读 《自研 Agent 接入飞书 CLI》
- 看
extension/扩展包 — 通过 wrappermain扩展，无需改 CLI 源码 - 任意飞书开放平台文档 URL 加
.md后缀可直接获取 Markdown 源
参考
- 项目主页：
https://github.com/larksuite/lark-cli - 中文文档：
README.zh.md（安装包内） - Skills 列表：
https://github.com/larksuite/lark-cli/tree/main/skills