lark-cli

在协作办公日益复杂的今天，如何在终端（Terminal）中高效操作飞书（Lark）？如何让 AI Agent 像人类一样自如地调度日历、管理文档、发送消息？

lark-cli 是一款由飞书开放平台官方推出的命令行工具，它不仅覆盖了消息、文档、多维表格、日历、邮箱等 11 大核心业务域，提供 200+ 精选命令，更革命性地内置了 19 个 AI Agent Skills。它是全球首款真正为 Agent 原生设计 的办公 CLI，让自动化办公从“脚本编写”进化为“自然语言驱动”。

为什么选择 lark-cli？

核心功能全景图

lark-cli 将飞书的复杂能力浓缩为简洁的终端指令：

• 📅 日历 (Calendar)：查看日程、创建会议、查询忙闲、智能时间建议。
• 💬 即时通讯 (IM)：发送/回复消息、群聊管理、搜索历史、下载媒体文件。
• 📄 云文档 (Docs)：基于 Markdown 创建/编辑文档、搜索内容、管理素材。
• 📊 多维表格 (Base)：管理字段/记录/视图、数据聚合分析、操作仪表盘。
• 📈 电子表格 (Sheets)：读写单元格、追加数据、导出报表。
• ✅ 任务 (Task)：创建/完成任务、管理子任务与提醒。
• 📧 邮箱 (Mail)：收发邮件、管理草稿、监听新邮件。
• 🎥 视频会议 (VC & Minutes)：查询会议纪要、获取 AI 总结/待办/逐字稿。
• 👤 通讯录 (Contact)：搜索用户信息、获取组织架构。
• 📚 知识库 (Wiki) & 云空间 (Drive)：管理知识节点、上传下载文件。

AI Agent 的原生利器：19 个专属 Skills

这是 lark-cli 最强大的特性。它预置了 19 个经过实测验证的 Skills，AI Agent（如 Claude Code, OpenClaw, Cursor 等）无需任何额外适配，即可直接调用：

1. lark-shared: 基础配置、鉴权、身份切换（自动加载）。
2. lark-calendar: 日程管理与时间规划。
3. lark-im: 消息收发与群聊互动。
4. lark-doc: 文档全生命周期管理。
5. lark-drive: 文件存取与权限控制。
6. lark-sheets: 表格数据操作。
7. lark-base: 多维表格深度交互。
8. lark-task: 任务流管理。
9. lark-mail: 邮件全流程处理。
10. lark-contact: 组织人员查询。
11. lark-wiki: 知识库维护。
12. lark-event: 实时事件订阅 (WebSocket)。
13. lark-vc: 会议记录检索。
14. lark-minutes: 妙记 AI 产物提取。
15. lark-whiteboard: 画板 DSL 渲染。
16. lark-openapi-explorer: 底层 API 探索。
17. lark-skill-maker: 自定义 Skill 框架。
18. lark-workflow-meeting-summary: 工作流：自动汇总会议纪要。
19. lark-workflow-standup-report: 工作流：自动生成站会报告。

效果：你只需对 AI 说“帮我总结一下昨天的会议纪要并发到项目群”，AI 即可自动调用 lark-minutes 获取总结，再调用 lark-im 发送消息，全程无需人工干预。

⚡ 快速开始：三步直达

1. 安装 (推荐 npm)

# 安装 CLI 核心
npm install -g @larksuite/cli

# 安装 CLI Skills (必需，否则 AI 无法调用)
npx skills add larksuite/cli -y -g

2. 配置与登录

# 交互式创建应用并配置凭证
lark-cli config init

# 一键登录（自动推荐常用权限）
lark-cli auth login --recommend

系统会弹出浏览器授权页面，确认后即可完成本地凭证存储（利用 OS 密钥链，安全无忧）。

3. 开始使用

# 人类用户：查看今日日程
lark-cli calendar +agenda

# AI Agent：自动调用 Skill 发送消息
# (Agent 内部执行)
lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello from AI!"

三层调用架构：按需选择粒度

lark-cli 设计了灵活的三层命令体系，满足从小白到极客的所有需求：

Level 1: 快捷命令 (Shortcuts) 🚀

• 前缀：+
• 特点：对人类和 AI 最友好。内置智能默认值、表格化输出、Dry-run 预览。
• 示例：

  lark-cli docs +create --title "周报" --markdown "# 本周进展..."
  

Level 2: API 命令 (API Commands) ⚙️

• 来源：从飞书 OAPI 元数据自动生成，经筛选的 100+ 精选命令。
• 特点：与平台端点一一对应，适合精确控制。
• 示例：

  lark-cli calendar events instance_view --params '{"calendar_id":"primary"...}'
  

Level 3: 通用 API 调用 (Raw API) 🔓

• 特点：覆盖飞书开放平台 2500+ 所有 API，无死角。
• 示例：

  lark-cli api POST /open-apis/im/v1/messages --body '{"msg_type":"text"...}'
  

安全与最佳实践

鉴于 AI Agent 的强大执行力，lark-cli 内置了多重防护：

• 凭证安全：使用操作系统原生密钥链（Keychain/Credential Manager）存储 Token，绝不明文落地。
• 输入净化：防止提示词注入导致的意外命令执行。
• 输出脱敏：自动过滤敏感字段，防止日志泄露。
• Dry-run 机制：对写操作建议先加 --dry-run 预览请求内容。
• 最小权限原则：建议仅授予机器人必要的 Scope，并严禁将私人助手机器人拉入公共群聊。

典型应用场景

1. AI 自动站会：每天早晨，AI 自动调用 lark-calendar 获取日程，lark-task 获取昨日任务，生成站会报告发到群里。
2. 会议纪要闭环：会议结束后，AI 自动提取 lark-minutes 中的待办事项，创建为 lark-task 并分配给责任人。
3. 终端办公流：开发者无需离开终端，即可查询文档、回复消息、更新多维表格进度，保持心流不中断。
4. 数据自动同步：监听 lark-event 事件，当有新表单提交时，自动写入 lark-sheets 或推送到外部数据库。