飞书官方 CLI 工具来了!让 AI Agent 也能在终端里＂玩转＂飞书

“终于，人类和 AI 可以在同一个终端里操作飞书了。”

最近，Lark（飞书海外版名称）开放平台悄悄上线了一款命令行神器——lark-cli。这可不是普通的开发者工具，它是首个为 AI Agent 原生设计的办公平台 CLI，覆盖日历、文档、多维表格、即时通讯等 11 大核心业务域，提供 200+ 命令。

无论你是想批量处理表格的开发者，还是想让 AI 助手帮你管理日程的效率达人，这篇文章都值得收藏。

为什么开发者需要 lark-cli？

1. 为 AI Agent 而生，但人类用着更爽

传统的 API 工具往往只考虑人类开发者，但 lark-cli 从设计之初就思考了一个问题：如何让 AI Agent 也能高效、安全地调用飞书能力？

结果是——19 个开箱即用的 Agent Skills，适配主流 AI 工具（如 Claude、GPT 等）。这意味着：

• 你可以让 AI 直接帮你”查一下下周的会议安排”
• 让 AI 自动整理多维表格数据并生成报告
• 甚至构建一个能自动回复群消息的 AI 机器人

对人类更友好的是：每条命令都经过 AI 实测验证，参数更智能、输出更结构化，你写脚本时再也不用翻半天 API 文档。

2. 三层调用架构，从”傻瓜式”到”极客式”

lark-cli 提供了三种使用粒度，满足不同场景：

举个例子：发送一条消息，你可以简单到：

lark-cli im +messages-send --chat-id "oc_xxx" --text "今晚加班，不用等我😭"

也可以精细控制到 API 参数级别。

3. 200+ 命令，覆盖 11 大业务域

从日历日程到多维表格，从邮箱到视频会议，你能想到的飞书功能，基本都能在终端里完成：

• 📅 日历：查日程、建会议、看忙闲、给时间建议
• 📊 多维表格：创建表格、增删字段、数据聚合分析
• 📄 云文档：Markdown 创建/读取/更新，支持素材与画板
• 💬 即时通讯：发消息、管群聊、搜记录、下文件
• ✅ 任务：创建任务清单、分配子任务、设提醒
• 📧 邮箱：收发邮件、管理草稿、监听新邮件
• 🎥 视频会议：搜会议记录、查纪要、下录制

三分钟上手：从安装到第一条命令

Step 1：安装（两种方式任选）

推荐方式——npm 一键安装：

npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g  # 安装必需 Skill

极客方式——源码编译：

git clone https://github.com/larksuite/cli.git
cd cli && make install

Step 2：配置应用凭证（仅需一次）

lark-cli config init

按提示输入你的飞书应用凭证，支持交互式引导。

Step 3：登录授权

lark-cli auth login --recommend

--recommend 会自动选择常用权限，省去你一个个勾选的麻烦。

Step 4：开始玩耍！

# 查看今天日程
lark-cli calendar +agenda

# 创建一个周报文档
lark-cli docs +create --title "周报" --markdown "# 本周进展\n- 完成了 lark-cli 调研"

# 发送一条消息
lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello from Terminal 🚀"

AI Agent 使用指南

如果你是 AI Agent（或正在协助用户配置 AI），流程稍有不同：

# 1. 安装
npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g

# 2. 初始化（后台运行，提取授权链接给用户）
lark-cli config init --new

# 3. 登录（同上，提取链接给用户浏览器完成）
lark-cli auth login --recommend

# 4. 验证状态
lark-cli auth status

关键参数：--no-wait 模式可以让命令立即返回验证 URL，不阻塞终端，非常适合 AI 自动化流程。

进阶玩法：让终端输出更”聪明”

多种输出格式，管道友好

--format json      # 完整 JSON（默认）
--format pretty    # 人类可读
--format table     # 表格形式
--format ndjson    # 换行分隔 JSON，适合管道
--format csv       # 直接导出表格

自动分页，批量处理

lark-cli sheets records list --page-all           # 获取所有数据
lark-cli sheets records list --page-limit 5       # 最多 5 页
lark-cli sheets records list --page-delay 500     # 每页间隔 500ms

Dry Run 预览，安全第一

对于可能产生副作用的操作，先用 --dry-run 看看会发生什么：

lark-cli im +messages-send --chat-id oc_xxx --text "test" --dry-run

Schema 自省，不用看文档

lark-cli schema calendar.events.instance_view  # 查看参数结构

⚠️ 安全提示：使用前必读

lark-cli 功能强大，但也意味着权限越大，责任越大：

1. AI Agent 将以你的身份执行操作，授权范围决定了它能做什么
2. 建议作为私人助手使用，不要拉入群聊或允许其他用户交互
3. 默认安全配置不建议修改，放开限制会显著提高风险
4. 输入防注入、终端输出净化、OS 原生密钥链存储——这些保护措施已内置，但谨慎操作仍是第一原则

• 开源地址：https://github.com/larksuite/cli

本文基于 lark-cli 官方文档整理，工具持续更新中，请以最新版本为准。