OpenClaw 接入飞书 CLI:让 AI 管家直接操控飞书

三步接入，200+ 命令，AI 帮你发消息、查日历、搜文档——不用再手动切 App 了。

●

01

一、为什么要让 AI 接管飞书

我在用 OpenClaw（一个本地运行的 AI 管家）处理日常工作，Telegram 发指令，贾维斯帮我执行。

用下来最大的痛点是：飞书这个坑。

每次要发消息、查日程，都得自己打开 App，手动操作。明明旁边就有个 AI，非得自己点。

然后我发现了 lark-cli——飞书官方出的命令行工具，专门为 AI Agent 设计的。200+ 命令，19 个 Agent Skill，MIT 开源。

接入之后，我跟贾维斯说「发飞书消息给 XXX」，它直接发了。

这篇文章记录整个接入过程，手把手的那种。

●

02

二、lark-cli 是什么

飞书官方出品的 CLI 工具，GitHub 地址：larksuite/cli

覆盖范围：

专门针对 AI Agent 优化：

- 参数精简，结构化输出，AI 调用成功率高

- 19 个 Skill 文件，主流 AI 工具（Claude Code、OpenClaw、Windsurf）直接可用

- MIT 开源，npm 一键安装

●

03

三、安装（3分钟搞定）

第一步：安装 CLI 本体

npm install -g @larksuite/cli

第二步：安装 Agent Skills

npx skills add larksuite/cli -y -g

安装完成后，19 个 Skill 文件会自动同步到 OpenClaw、Claude Code、Windsurf 等工具的 skills 目录。

安装完验证一下：

lark-cli --help

看到命令列表说明装好了。

●

04

四、配置飞书 App 凭证

第一步：创建飞书应用

国内飞书用户：打开 open.feishu.cn，创建一个「企业自建应用」。

国际版 Lark 用户：打开 open.larksuite.com。

创建完成后，在「应用凭证与基本信息」页面拿到：

- App ID（cli_ 开头）

- App Secret

第二步：写入配置

echo '你的AppSecret' | lark-cli config init \   --app-id cli_你的AppID \   --app-secret-stdin \   --brand feishu

输出 OK: Configuration saved 就成功了。

验证配置：

lark-cli config show

●

05

五、OAuth 授权：让 CLI 获取用户权限

App 凭证只是机器人身份，要用用户身份（查你自己的日历、发你的消息），需要 OAuth 授权。

发起授权（Device Flow）

lark-cli auth login --domain all --no-wait --json

输出一个 verification_url 和 user_code，在浏览器打开链接，输入验证码授权。

完成授权

lark-cli auth login --device-code 你的device_code

等待授权完成，看到 登录成功! 用户: 你的名字 就行了。

验证连接

lark-cli doctor

7 项全部 pass，说明配置完全正确：

{   "checks": [     { "name": "config_file",    "status": "pass" },     { "name": "app_resolved",   "status": "pass" },     { "name": "token_exists",   "status": "pass" },     { "name": "token_local",    "status": "pass" },     { "name": "token_verified", "status": "pass" },     { "name": "endpoint_open",  "status": "pass" },     { "name": "endpoint_mcp",   "status": "pass" }   ],   "ok": true }

●

06

六、实际效果演示

接入 OpenClaw 后，我跟贾维斯说：

「飞书发消息给李嘉图」

它先搜索用户拿到 open_id：

lark-cli contact +search-user --query '李嘉图' # 返回 open_id: ou_15c1ccc804246b331ca4b02329415bd7

再发消息：

lark-cli im +messages-send \   --user-id ou_15c1ccc804246b331ca4b02329415bd7 \   --text '你好，这是贾维斯发来的测试消息 🦞' \   --as bot

飞书里秒收到。

其他可以直接用的命令：

# 查今日日程 lark-cli calendar +agenda  # 创建会议 lark-cli calendar events create --params '{"summary":"周会"}'  # 搜索文档 lark-cli drive +search --query '项目文档'  # 查邮件 lark-cli mail +inbox

●

07

七、注意事项

Token 有效期：OAuth Token 有效期约 2 小时，到期后需要重新执行 lark-cli auth login --domain all。

Bot vs User 身份：发消息、创建内容等写操作需要 --as bot；查日历、搜索等读操作用 --as user 或默认 auto。

应用权限：如果某个操作报权限错误，去飞书开放平台 → 应用 → 权限管理，开启对应权限范围，审核通过后重新授权即可。

●

08

写在最后

lark-cli 是飞书官方出品，更新及时，文档完整，200+ 命令覆盖了日常 90% 的飞书操作需求。

接入 OpenClaw 之后，飞书从一个需要手动操作的 App，变成了贾维斯的一个能力模块。发消息、查日历、搜文档——说一句话就好。

如果你也在用 OpenClaw 或者其他 AI Agent，这个工具值得接一下。

GitHub：https://github.com/larksuite/cli