飞书 CLI + Skill 详细配置指南：让 AI 真正替你操作飞书

飞书 CLI + Skill 详细配置指南：让 AI 真正替你操作飞书

一行命令安装，三分钟配置完成，从此让 AI 帮你管日程、发消息、写文档、处理表格。

前言

你有没有想过，让 AI 不只是"嘴上说说"，而是真的能打开你的飞书、帮你发消息、建日程、整理表格？

飞书官方开源的 lark-cli 就是这样一把钥匙。它把飞书开放平台 2500+ 个 API 封装成了简洁的命令行工具，再配合 26 个开箱即用的 AI Agent Skill，任何 AI 助手（Claude Code、Cursor、Codex、Trae、豆包等）都能在几分钟内学会操作你的飞书。

本文将带你从零开始，一步步完成安装、配置到实际使用的全过程。每一步都经过验证，跟着做就能跑通。

一、先搞清楚：CLI 和 Skill 分别是什么？

在动手之前，先理清两个核心概念：

1.1 lark-cli：飞书的命令行工具

lark-cli 是飞书官方维护的开源命令行工具（GitHub: larksuite/cli），用 Go 语言编写。它的作用是：把飞书开放平台的 API 变成你在终端里直接敲的命令。

举个例子，以前你要调用飞书"获取日程列表"的 API，需要写代码、处理鉴权、拼参数、解析返回。现在只需要：

lark-cli calendar +agenda

它覆盖了飞书 18 个业务域、200+ 条命令，包括：

1.2 Skill：给 AI 看的"操作手册"

光有命令行工具还不够——AI 怎么知道该敲哪个命令、参数怎么传？

这就是 Skill 的意义。每个 Skill 是一个结构化的指南文件（Markdown 格式），告诉 AI：

• 这个业务域能做什么、不能做什么
• 遇到什么场景该用哪个命令
• 命令的参数怎么填、有什么坑
• 常见的用户意图怎么映射到具体操作

比如 lark-calendar Skill 会告诉 AI：“用户说’帮我约个会’，你应该先查忙闲、再推荐时间、最后创建日程。”

CLI 是工具，Skill 是说明书。 两者配合，AI 才能真正独立完成飞书操作。

二、环境准备

在安装之前，确认你的电脑满足以下条件：

2.1 必备条件

• Node.js ≥ 16（npm / npx 可用）
• 飞书账号（能正常登录飞书）
• 网络能访问飞书开放平台（国内用户无需额外配置）

检查 Node.js 版本：

node –version
# 输出示例：v18.17.0

如果没有安装 Node.js，去 Node.js 官网 下载 LTS 版本安装即可。

2.2 可选条件

• Go 1.23+ 和 Python 3（仅从源码编译时需要，普通用户不需要）
• 飞书开放平台开发者权限（后面会引导你创建应用，不需要提前准备）

三、安装飞书 CLI

3.1 一键安装（推荐）

打开终端（macOS/Linux 用 Terminal，Windows 用 PowerShell），执行：

npx @larksuite/cli@latest install

这条命令会自动完成以下事情：

💡 Windows 用户注意：PowerShell 同样可以运行，但 JSON 参数的引号转义有细节差异，文末 FAQ 会说明。

3.2 验证安装

安装完成后，验证一下：

lark-cli –version

如果输出版本号（比如 v1.0.78+xxxxxxx），说明安装成功。

再看看帮助信息，感受一下它支持哪些业务域：

lark-cli –help

你会看到一长串 domain 列表：approval、calendar、contact、docs、drive、im、mail、sheets、task…… 这些就是飞书的各个业务模块。

3.3 从源码安装（不推荐，仅开发者用）

如果你想从源码编译安装，需要先装 Go 1.23+ 和 Python 3：

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

# 安装 CLI Skill（必须）
npx skills add larksuite/cli -y -g

普通用户跳过这一步即可。

四、配置应用与授权

安装完 CLI 之后，还不能直接用——你需要让 CLI 知道"以谁的身份"去调用飞书 API。

整个配置流程分两步：

4.1 交互式配置（推荐）

lark-cli 提供了一键引导配置，在终端执行：

lark-cli config init

这会启动一个交互式引导流程，它会：

跟着终端里的提示操作即可。

💡 提示：如果你已经有飞书应用的 App ID 和 App Secret，也可以手动填入。

4.2 创建新应用（AI Agent 场景）

如果你是在 AI Agent 环境中安装，希望自动化完成，可以用：

lark-cli config init –new

这条命令会输出一个浏览器授权链接，把链接发给用户，用户在浏览器中完成应用创建和确认后，命令会自动退出并保存配置。

4.3 登录授权

应用配置好之后，还需要用户登录授权——也就是让应用拿到你的用户身份令牌。

执行推荐的一键登录：

lark-cli auth login –recommend

–recommend 参数会自动勾选常用的权限范围（日程、消息、文档、表格等），不用你一个个选。

执行后会弹出浏览器（或者给你一个链接），用飞书账号扫码或登录确认即可。

4.4 验证登录状态

lark-cli auth status

如果显示已登录、以及授权的权限列表，说明配置成功。

你也可以查看应用支持的所有权限：

lark-cli auth scopes

五、Skill 是什么？怎么装？

5.1 Skill 的安装位置

如果你用 npx @larksuite/cli@latest install 安装，Skill 会自动装好，不需要额外操作。

手动安装 Skill 的命令是：

npx skills add larksuite/cli -y -g

-g 表示全局安装，-y 表示自动确认。

5.2 所有 Skill 一览

lark-cli 目前内置了 26 个 AI Agent Skill，覆盖飞书全部核心业务：

5.3 Skill 怎么被 AI 使用？

AI Agent 在操作飞书时，会先读取对应 Skill 的 SKILL.md 文件，了解：

• 场景识别：用户的这句话对应什么操作？
• 路由规则：该调用哪个命令、走哪条流程？
• 前置条件：做这件事之前需要先确认什么？
• 执行规范：参数怎么填、有哪些坑要避开？

举个例子，lark-calendar Skill 里明确写了：

凡是涉及预约日程/会议室、调整时间，第一步必须先读 schedule-meeting.md，不能直接创建。

这样 AI 就不会一上来就瞎约会议，而是先查忙闲、推荐时间、确认会议室，再创建。

Skill 的本质，是把飞书产品的最佳实践编码成 AI 能理解的结构化指南。

六、实战：五个常用场景上手

光说不练假把式。下面用五个真实场景，带你感受 lark-cli 的威力。

场景 1：查看今天的日程

lark-cli calendar +agenda

这会列出你今天的所有日程，按时间排序。

指定日期范围：

lark-cli calendar +agenda –start 2026-08-01 –end 2026-08-07

场景 2：发送一条飞书消息

先找到你要发消息的群或人的 chat_id（可以通过搜索群名）：

lark-cli im +chat-search –query "产品周会"

拿到 chat_id（oc_ 开头）后，发消息：

lark-cli im +messages-send –chat-id "oc_xxxxxxxx" –text "大家好，本周周会改到下午3点"

⚠️ 安全提示：发消息属于写操作，执行前建议先用 –dry-run 预览：

lark-cli im +messages-send –chat-id "oc_xxxxxxxx" –text "测试" –dry-run

场景 3：创建一个在线表格

lark-cli sheets +workbook-create –title "Q3 销售数据"

创建成功后会返回表格链接，你可以在浏览器中打开查看。

往表格里写入数据：

lark-cli sheets +cells-set \\
–url "https://example.feishu.cn/sheets/shtxxxxxxxx" \\
–sheet-name "Sheet1" \\
–range "A1:B3" \\
–cells '[
{"type": "text", "value": "月份"},
{"type": "text", "value": "销售额"},
{"type": "text", "value": "7月"},
{"type": "number", "value": 125000},
{"type": "text", "value": "8月"},
{"type": "number", "value": 138000}
]'

场景 4：创建一篇文档

lark-cli docs +create \\
–doc-format markdown \\
–content $'# 周报\\n\\n## 本周完成\\n– 项目 A 上线\\n– 项目 B 需求评审\\n\\n## 下周计划\\n– 项目 C 启动'

场景 5：创建一个任务

lark-cli task tasks create \\
–data '{"summary": "完成季度报告", "due": {"timestamp": "1756560000", "is_all_day": true}}'

七、三层命令体系：从简单到灵活

lark-cli 提供了三种不同粒度的命令方式，覆盖从"一键操作"到"完全自定义"的各种需求。

7.1 第一层：Shortcut（推荐优先使用）

以 + 开头，是对常用操作的高级封装。参数简洁、输出友好、自带智能默认值。

lark-cli calendar +agenda
lark-cli im +messages-send –chat-id "oc_xxx" –text "你好"
lark-cli sheets +workbook-create –title "我的表格"

能用 Shortcut 就用 Shortcut，这是官方推荐的最佳实践。

查看某个 domain 下有哪些 Shortcut：

lark-cli calendar –help

7.2 第二层：API Command（平台原生）

和飞书开放平台 API 一一对应，100+ 条命令，参数结构与官方文档一致。

lark-cli calendar calendars list
lark-cli im messages list –params '{"container_id_type":"chat","container_id":"oc_xxx"}'

当 Shortcut 不够用时，可以用 API Command 直接调用平台接口。

调用前先看参数结构：

lark-cli schema calendar.events.create

7.3 第三层：Raw API（兜底方案）

直接调用任意飞书开放平台端点，覆盖 2500+ API。

lark-cli api GET /open-apis/calendar/v4/calendars
lark-cli api POST /open-apis/im/v1/messages \\
–params '{"receive_id_type":"chat_id"}' \\
–data '{"receive_id":"oc_xxx","msg_type":"text","content":"{\\"text\\":\\"hello\\"}"}'

这是终极兜底方案——只要飞书开放平台有这个 API，你就能用。

八、实用技巧

8.1 输出格式控制

默认输出 JSON，你也可以切换成其他格式：

# 人类友好的格式化输出
lark-cli calendar +agenda –format pretty

# 表格形式
lark-cli calendar +agenda –format table

# CSV 格式（方便导入 Excel）
lark-cli sheets +csv-get –url "…" –sheet-name "Sheet1" –format csv

# 逐行 JSON（适合管道处理）
lark-cli im +chat-list –format ndjson

8.2 用 jq 过滤 JSON 输出

lark-cli 内置了 –jq 参数，可以直接过滤 JSON 结果：

# 只提取日程标题
lark-cli calendar +agenda –jq '.data.items[].summary'

8.3 分页处理

对于列表类接口，支持自动翻页：

# 自动翻完所有页
lark-cli im +chat-list –page-all

# 最多翻 5 页
lark-cli im +chat-list –page-limit 5

# 每页之间间隔 500ms
lark-cli im +chat-list –page-all –page-delay 500

8.4 Dry Run 预览

写操作之前，先用 –dry-run 预览请求内容，确认无误再执行：

lark-cli im +messages-send –chat-id "oc_xxx" –text "测试" –dry-run

8.5 多身份切换

应用可以同时以"用户身份"或"机器人身份"执行命令：

# 以用户身份（默认）
lark-cli calendar +agenda –as user

# 以机器人身份
lark-cli im +messages-send –as bot –chat-id "oc_xxx" –text "来自机器人的消息"

九、安全与风险提示

飞书 CLI 能让 AI 操作你的飞书账号，这本身是一把双刃剑。以下安全事项请务必了解：

9.1 默认安全保护

lark-cli 内置了多层安全保护：

• 输入注入防护：防止恶意内容通过命令参数注入
• 终端输出脱敏：敏感信息不会直接打印到终端
• 系统钥匙串存储：凭证存在系统原生钥匙串中，不明文存储
• 风控信号：向飞书官方发送最小化的风控信号，帮助识别异常调用

9.2 高风险操作确认

对于删除、批量修改等高风险操作，CLI 会要求加 –yes 参数确认：

# 删除消息（高风险，需要 –yes 确认）
lark-cli im messages delete –message-id "om_xxx" –yes

9.3 使用建议

十、接入 AI Agent

安装配置完成后，怎么让你的 AI 助手用上它？

10.1 支持的 AI Agent

目前已验证支持主流 AI Agent 工具：

• Claude Code
• Cursor
• Codex
• Trae
• GitHub Copilot
• Windsurf
• 豆包（本文所在平台）

10.2 接入方式

大多数 AI Agent 会自动发现系统中安装的 Skill。你只需要：

然后直接跟 AI 说飞书相关的需求就行，比如：

“帮我看看今天下午有什么会” “给产品群发一条通知” “帮我建一个表格记录本周任务”

AI 会自动读取对应的 Skill，调用 lark-cli 完成操作。

十一、常见问题 FAQ

Q1：安装后提示 “command not found: lark-cli”

A：说明安装路径不在 PATH 里。

• macOS/Linux：检查 /usr/local/bin 是否在 PATH 中
• Windows：检查 npm 全局安装路径是否在 PATH 中
• 也可以手动找到二进制文件位置，加到 PATH 里

Q2：授权失败，提示"授权码已过期"

A：OAuth 授权链接有时效性（通常几分钟），超时后重新执行 lark-cli auth login 即可。

Q3：调用 API 提示权限不足

A：说明你的应用没有申请对应权限。

Q4：Windows PowerShell 里 JSON 参数报错

A：PowerShell 对引号的处理和 bash 不同。建议把 JSON 写到文件里，用 @文件名 的方式传入：

# 创建 data.json 文件，写入 JSON 内容
lark-cli sheets +cells-set —url "…" —sheet-name "Sheet1" —range "A1:B2" —cells "@data.json"

Q5：支持国际版 Lark 吗？

A：支持。lark-cli 同时支持国内版飞书和国际版 Lark，在配置时选择对应的域名即可。

Q6：企业管理员能控制权限吗？

A：可以。企业管理员可以在飞书管理后台控制哪些应用可以安装、哪些 API 可以调用。

十二、总结

回顾一下，我们今天讲了什么：

飞书 CLI + Skill 的组合，本质上是在"飞书开放平台"和"AI Agent"之间架了一座桥。以前你需要写代码、调 API 才能让程序操作飞书，现在你只需要跟 AI 说一句话，它就能自己查文档、调命令、完成操作。

AI 不只是聊天工具，它正在变成真正能帮你干活的数字同事。 而飞书 CLI，就是它接入你工作流的第一站。

参考资源

• 🔗 GitHub 开源仓库：https://github.com/larksuite/cli
• 🔗 飞书官方介绍页：https://www.feishu.cn/feishu-cli
• 🔗 飞书开放平台：https://open.feishu.cn/

本文基于 lark-cli v1.0.78 版本撰写，工具持续更新中，如有出入请以官方文档为准。