核心信息
LarkSuite CLI (lark-cli) 是飞书（Lark/Feishu）官方命令行工具，由 larksuite 团队维护，专为人类用户和 AI Agent 设计。覆盖 17 个业务域、200+ 精选命令、24 个 AI Agent Skills，MIT 开源协议。
项目概况
| 属性 | 值 |
|---|
| Stars | 12,158 |
| 语言 | Go (主) |
| 许可证 | MIT |
| 最新版本 | v1.0.36 (2026-05-21) |
| 定位 | 人类 & AI Agent 双身份飞书 CLI |
核心架构
三层命令系统
- Shortcuts（
+ 前缀） — 人类和 AI 都友好的快捷命令，智能默认值、表格输出、dry-run 预览
- API Commands — 与平台 API 同步的完整命令，覆盖飞书开放平台全部接口
- Raw API — 直接调用底层 API，全覆盖
支持的 17 个业务域
| 域 | 能力 |
|---|
| 📅 Calendar | 日程查看/创建/更新，参会人邀请，会议室查找 |
| 💬 Messenger | 发/回复消息，群聊管理，聊天记录搜索 |
| 📄 Docs | 文档创建/读取/更新/搜索，富媒体和白板 |
| 📁 Drive | 文件上传/下载，文档搜索，评论管理 |
| 📝 Markdown | 驱动原生 .md 文件的 CRUD 操作 |
| 📊 Base | 多维表格：表/字段/记录/视图/仪表盘/工作流 |
| 📈 Sheets | 电子表格创建/读取/写入/追加/查找/导出 |
| 🖼️ Slides | 演示文稿创建/管理，幻灯片增删 |
| ✅ Tasks | 任务创建/查询/更新/完成，子任务和提醒 |
| 📚 Wiki | 知识空间、节点、文档管理 |
| 👤 Contact | 用户搜索（姓名/邮箱/手机），获取个人资料 |
| 📧 Mail | 邮件浏览/搜索/读取/发送/回复/转发/草稿 |
| 🎥 Meetings | 会议记录查询，纪要/待办/转录 |
| 🕐 Attendance | 个人考勤签到记录查询 |
| ✍️ Approval | 审批查询/通过/拒绝/转交/抄送 |
| 🎯 OKR | OKR 创建/查询/更新，目标与关键结果管理 |
| 📋 Project | Meegle 项目管理（需单独安装 meegle-cli） |
24 个 Agent Skills
所有 Skill 均以 lark- 为前缀，可直接被 AI Agent 调用：
| Skill | 功能 |
|---|
lark-im | 即时消息：发送/回复/群管理 |
lark-calendar | 日程管理：CRUD + 忙闲查询 |
lark-doc | 文档操作（Markdown 基础） |
lark-drive | 云盘文件管理 |
lark-markdown | 驱动原生 Markdown 文件 |
lark-sheets | 电子表格操作 |
lark-slides | 幻灯片管理 |
lark-base | 多维表格全功能 |
lark-task | 任务管理 |
lark-mail | 邮件操作 |
lark-contact | 联系人搜索 |
lark-wiki | 知识库管理 |
lark-event | 实时事件订阅（WebSocket） |
lark-vc | 视频会议记录查询 |
lark-whiteboard | 白板/图表 DSL 渲染 |
lark-minutes | 会议纪要 AI 产物 |
lark-openapi-explorer | OpenAPI 接口探索 |
lark-skill-maker | 自定义 Skill 创建框架 |
lark-attendance | 考勤查询 |
lark-approval | 审批操作 |
lark-workflow-meeting-summary | 工作流：会议纪要汇总 |
lark-workflow-standup-report | 工作流：站会/待办汇总 |
lark-okr | OKR 管理 |
安全设计
- 输入注入防护 — 终端输出清洗（sanitization）
- OS 原生凭据存储 — 使用系统 keychain 而非明文
- OAuth 登录 — 交互式 TUI 引导，支持推荐权限域
- Agent 模式 — 支持
--no-wait 异步登录 + device code 轮询
- 身份切换 —
--as user / --as bot 灵活切换
安装方式
# npm 安装（推荐）
npm install -g @larksuite/cli
# 或 Go 编译
go install github.com/larksuite/cli@latest
# 验证
lark-cli --version
学以致用
- 当前 Agent（GenericAgent）已通过 lark-cli 实现飞书消息发送、文件发送等功能
- 可进一步集成
lark-calendar、lark-doc、lark-base 等 Skill，实现飞书全功能 Agent 管控
lark-skill-maker 工具可自定义飞书相关 Skill，扩展 Agent 能力边界
关联连接