larksuite/cli

lark-cli – Lark/飞书的命令行接口

是什么 – 用 Go/Node 编写的开源 CLI，让人类和 AI 代理能够与 Lark/飞书生产力套件进行交互。它将 2,000 多个开放平台 API 封装为 200 多个即用型命令和一组专为 AI 驱动自动化设计的“技能”

核心功能

• 广泛覆盖 – 日历、消息、文档、云盘、表格、幻灯片、任务、邮件、会议、OKR、维基、联系人、审批、考勤、Base 表格等
• 三层命令模型
  1. 快捷命令 (+agenda, +messages-send) – 人类和 AI 友好，带有默认值和表格输出
  2. API 命令 – 自动生成的与 Lark 开放 API 端点的一一映射
  3. 原始 API – 直接调用 2,500+ 个端点中的任意一个
• 原生支持 AI 代理的“技能” – 提供 24 个预打包的技能模块（如 lark-calendar, lark-im, lark-doc），为 AI 代理提供清晰、类型安全的接口，便于嵌入机器人或其他自动化流水线
• 安全优先 – 使用操作系统密钥链存储凭证，防止输入注入，支持可选的 DPoP（所有权证明），内置风险控制信号仅向飞书报告最少的设备信息
• 安装方式 – 通过 npx @larksuite/cli@latest install 一行命令安装，或使用 Go 1.23+ 从源码构建
• 认证方式 – 支持交互式 TUI 的 OAuth 流程、适用于代理的设备码模式，以及细粒度的权限范围选择

谁应该使用它

• 希望快速获得 Lark 服务终端接口的个人开发者
• 需要可靠、结构化访问 Lark 数据的 AI 助手、机器人或 RPA 流水线团队
• 希望将 CLI 嵌入内部工具、并具备集中式凭证存储和审计日志的企业

工作原理（概览）

1. 安装该包
2. 运行 lark-cli config init 注册应用并存储其客户端 ID/密钥
3. 认证（lark-cli auth login）
4. 发出命令 – 既可以使用快捷命令（lark-cli calendar +agenda），也可以使用原始 API 调用（lark-cli api GET /open-apis/calendar/v4/calendars）

输出格式 – JSON（默认）、美化输出、表格、CSV、NDJSON，便于将结果管道化到其他脚本或 AI 流水线中

风险与缓解措施 – README 警告 AI 代理可能无意中执行有害操作；默认保护措施（输入清理、有限的令牌使用信号）已启用，建议用户不要放宽这些限制

许可证 – MIT，需遵守 Lark/飞书服务条款的常规要求

---

所有细节均直接取自仓库的 README