larksuite/cli

项目介绍

lark-cli 是 larksuite 团队维护的官方飞书/Lark 命令行工具。它把 Messenger、Docs、Drive、Base、Sheets、Slides、Calendar、Mail、Tasks、Meetings、Wiki、Contact、Attendance、Approval、OKR 和应用创建等操作搬到终端，提供 200 多条精选命令和 26 个 AI Agent Skills（仓库、功能与命令）。

命令分为三层：以 + 为前缀的快捷命令，带智能默认值和表格输出，适合人和 AI 直接使用；由 Lark OAPI 元数据生成的 API 命令，与平台端点一一对应；以及 lark-cli api 原始调用，可访问任意开放平台端点（三层命令体系）。结构化 JSON 输出、分页参数、dry-run 预览和 schema 查询使脚本和 Agent 都能获得稳定、可预测的响应。

快速开始

前提：安装 Node.js（含 npm/npx）。从源码构建还需要 Go 1.23+ 和 Python 3。

通过 npm 安装：

npx @larksuite/cli@latest install

然后配置凭据、登录并执行第一条命令：

lark-cli config init
lark-cli auth login --recommend
lark-cli calendar +agenda

config init 是一次性的交互式应用凭据配置。auth login --recommend 会自动选择常用权限范围；也可以按业务域或精确 scope 登录，例如 lark-cli auth login --domain calendar,task 或 lark-cli auth login --scope "calendar:calendar:read"（认证）。

AI Agent 使用相同流程，但需要把配置和登录命令放到后台运行，提取授权 URL 交给用户在浏览器完成，最后用 lark-cli auth status 验证（AI Agent 快速开始）。源码构建在 make install 之后还需安装 CLI Skill：npx skills add larksuite/cli -y -g。

认证与命令使用

登录后会保存凭据并记录已授予的权限。auth status、auth check、auth scopes 和 auth list 可查看当前用户与权限。命令支持以用户或机器人身份执行：--as user 或 --as bot。新的本地凭据默认启用 DPoP 持有证明，可设为 preferred、disabled 或 required；切换策略后需要重新授权。

默认 --format json 下，成功结果写入 stdout、退出码为 0，外层为 { "ok": true, ... }；错误写入 stderr、退出码非 0，外层为 { "ok": false, "error": { ... } }。判断成功应检查 ok 或退出码，而不是顶层 code 字段；上游 OpenAPI 错误码位于 error 内。im +messages-send 等快捷命令支持 --dry-run 预览有副作用的请求。用 lark-cli schema <method> 查询参数、请求体、响应结构、支持的身份和权限范围（高级用法、错误约定）。

使用约束与风险

授权后，CLI 会在所授予的权限范围内以你的用户身份行事；由 AI Agent 驱动时还可能受到模型错误或提示注入影响。文档建议不要主动放宽默认安全设置，并把接入的机器人当作私人助手，不要加入群聊或允许其他人调用，以免权限滥用或数据泄露（安全说明）。

默认情况下，CLI 在向官方飞书/Lark HTTPS 域名发起请求时会携带操作系统类型和设备硬件型号作为风控信号，可按工作区用 lark-cli config risk-control off|on|default 调整。代码采用 MIT 许可证，但调用底层 API 还需遵守飞书/Lark 的服务条款和隐私政策。Meegle 项目管理由独立的 meegle-cli 提供，需要单独安装（meegle-cli）。企业集中管理凭据和审计日志的嵌入方式另有文档（嵌入指南）。

HotRepo 点评

2026-11-13 的 Go 日榜记录显示，项目有 18,097 个 Star、1,380 个 Fork，当日新增 18 个 Star，Go 日榜最好名次为第 16。这更像是一个覆盖多个业务域、持续积累用户的官方 CLI，而不是短期爆量项目。最值得关注的是它明确服务两类使用者：面向 Agent 的快捷命令和 Skills，以及面向开发者的原始 API 调用。文档中关于风控数据上报和不要把机器人加入群聊的提醒，是在授予大范围权限前需要实际考虑的限制。