Lark CLI

Lark CLI（lark-cli）是 Lark/飞书 官方命令行，由 larksuite 团队维护，同时给人用和给 AI Agent 用。仓库 larksuite/cli 是 Go，MIT，创建于 2026-03-25。2026-09-20 GitHub 显示 17,312 star、1,390 fork。这是热度信号，不是访问量。GitHub 简介写的是 200+ 命令 和 20+ AI Agent Skills，覆盖消息、文档、多维表格、电子表格、日历、邮箱、任务、会议等。README 一处写 24 个结构化 Skill，另一处写 26 个。把这个区间当第一方措辞，不是点过的清单。

npm 包名是 @larksuite/cli。若你要的是写代码的智能体而不是操作飞书，对照 Claude Code 或 Codex CLI；若要更宽的技能包而不是飞书自带 Skills，对照 Agent Skills。

核心功能

• 面向 Agent 的 Skills：日历、即时消息、文档、云盘、Markdown、表格、幻灯片、多维表格、任务、邮箱、通讯录、知识库、事件、会议、白板、OpenAPI 探索、Skill 制作、考勤、审批、OKR，以及若干工作流。npx skills add larksuite/cli -y -g 安装技能包。
• 三层命令：给人/Agent 用的 + 快捷命令、按开放平台端点整理过的 API 命令，以及覆盖其余表面的 lark-cli api 原始调用。
• 给 Agent 的登录：lark-cli config init 与 lark-cli auth login --recommend。--no-wait 立刻返回验证 URL，方便 Agent 把浏览器步骤交给你。
• JSON 约定：--format json 成功时向 stdout 写 { "ok": true, ... }。错误走 stderr，ok: false。看 ok，不要拿原始 OpenAPI 的 code 当成败。
• 企业嵌入：extension/ 下的包装 main，以及嵌入文档。开放平台文档 URL 末尾加 .md 可取 Markdown。

限制：README 的安全说明写得很直白。拿到你 OAuth 范围的 Agent 可能泄露数据或做出你没打算的操作。默认有保护；放宽会抬高风险。不要把机器人拉进群。风控信号（操作系统类型和硬件型号）会发到官方飞书/Lark HTTPS 域名，除非你关掉。

适用场景

• 个人：想在终端或编码智能体里看日程、改文档、发消息。
• IT / ISV：把飞书嵌进内部 Agent，凭证集中管理。
• 别用：你只要通用编码 CLI，或机器上不能做飞书 OAuth。

定价方案

快速开始

1. npx @larksuite/cli@latest install
2. lark-cli config init，然后 lark-cli auth login --recommend
3. lark-cli auth status，再 lark-cli calendar +agenda

第一方入口：README 和嵌入指南。

常见问题

飞书还是 Lark？

同一产品线。国内品牌是飞书，国际品牌是 Lark。CLI 覆盖两边开放平台。

为什么有人嫌 Skill 太多？

技能包本来就按领域铺开。有人会用路由技能而不是加载全部领域技能。这是偏好，不是 CLI 坏了。

Agent 能独自装完吗？

安装和状态检查可以。config init 和 auth login 仍要你在浏览器里点。

替代方案

• Claude Code：编码智能体，可以把 Lark CLI 当工具调用。
• Codex CLI：OpenAI 终端智能体，不是飞书客户端。
• n8n：想要图形工作流而不是 CLI。

使用技巧

1. 先用 --recommend 范围，再用 auth login --domain 加领域。
2. 发送/创建类快捷命令先 --dry-run，再让 Agent 动手。
3. 熟悉端点之前，优先快捷命令而不是原始 api。

总结

Lark CLI 是官方提供的、让人或 Agent 在终端操作飞书的方式。你已经活在飞书里再装。保持默认安全设置，扩大范围前先读风险说明。