by AlexAnys
飞书插件 × OpenClaw 保姆级配置指南 & 社区支持 (0328 - 更新飞书cli调用指南,增加 API 耗尽根因排查、Lark Webhook 内网穿透方案)
# Add to your Claude Code skills
git clone https://github.com/AlexAnys/openclaw-feishu飞书 × OpenClaw 保姆级配置指南 & 社区支持 让每个人都能用飞书轻松接入 OpenClaw(原 Clawdbot)。
Skills 装了一堆,教程收藏了一堆,工具越来越多——但最缺的不是能力,而是经过国内适配和验证的场景。
39 个真实用例,含飞书、钉钉、企业微信、小红书等国内生态适配方案,每个都有完整步骤和可复制的提示词。
飞书官方开源了 Lark CLI(MIT 协议)——让你的 AI Agent 直接操作飞书:搜文档、读妙记、查日历、发消息、操作多维表格…… 2500+ API,11 个业务领域,19 个 AI Agent Skills。
安装只需要告诉你的 Agent 一句话,你只需要点一个授权链接。
飞书团队正式推出了 OpenClaw 飞书官方插件。目前飞书接入 OpenClaw 共有三种插件方式:
@openclaw/feishu),OpenClaw ≥ 2026.2 已内置👉 想了解飞书官方和 OpenClaw 内置插件的区别? 看 两个插件怎么选
👉 本项目插件的老用户? 看 如何迁移到飞书官方或 OpenClaw 内置插件
No comments yet. Be the first to share your thoughts!
🚀 OpenCrew — 把你的 OpenClaw 变成一支 AI 团队
多个 Agent 各管各的领域,Slack 频道=岗位,经验自动沉淀。
3 个 Agent 起步 · 10 分钟部署 · 不用写代码
飞书团队推出的 OpenClaw 官方插件,最大的不同是:以你的身份操作飞书(通过 OAuth 授权)。
这意味着 AI 不只是"聊天机器人",而是能直接帮你写文档、建多维表格、约日程、管理任务——就像一个能操作飞书的数字分身。
⚠️ OpenClaw 3.x 用户:官方安装工具
feishu-plugin-onboard有版本检查 bug(#59),会误报版本过低。安装指南中已提供替代方式,直接openclaw plugins install @larksuiteoapi/feishu-openclaw-plugin即可绕过。
📖 飞书团队的完整图文教程:OpenClaw 飞书官方插件上线 | 一文讲清功能、安装更新教程与常见问题
两个插件不能同时使用(安装官方插件时会自动禁用内置插件)。
| 维度 | 飞书官方插件 | OpenClaw 内置插件 |
|---|---|---|
| 操作身份 | 以你本人身份(OAuth) | 以机器人身份 |
| 消息 | 读取、发送、回复、搜索 | 读取、发送、回复 |
| 文档 | 创建 + 编辑 + 读取 | 读取为主 |
| 多维表格 | 完整操作(表、字段、记录、视图) | 基础读写 |
| 日历日程 | ✅ 创建/查询/修改/搜索/忙闲查询 | ❌ |
| 任务管理 | ✅ 创建/查询/更新/完成/子任务 | ❌ |
| 知识库 | ✅ 完整读写 | ✅ 只读 |
| 云盘 | ✅ 上传/下载 | ✅ 基础操作 |
| 流式输出 | ✅ | ✅ |
| 安装复杂度 | 需要额外安装 CLI 工具 + OAuth 授权 | OpenClaw 内置,openclaw channels add 即可 |
| 维护方 | 飞书团队 | OpenClaw 社区 |
| 问题反馈 | 飞书反馈群 | 本项目 Issues / Discord |
选飞书官方插件,如果你:
选 OpenClaw 内置插件,如果你:
⚠️ 两种插件互斥,只能启用一个。 安装飞书官方插件时会自动禁用内置插件,反之亦然。如果两个都装了,会出现
duplicate plugin id报错导致飞书功能不可用。遇到这种情况:# 删除用户目录下的重复插件 rm -rf ~/.openclaw/extensions/feishu openclaw gateway restart如果想从内置切换到官方插件,见 从 OpenClaw 内置插件迁移到飞书官方插件。
适用于:第一次使用 OpenClaw + 飞书的新用户,选择 OpenClaw 内置插件方案。 前提:已安装 OpenClaw 并正常运行(
openclaw gateway status能看到状态)。 预计耗时:15–20 分钟。
进入你刚创建的应用:
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": [
"aily:file:read",
"aily:file:write",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
⚠️ 这一步必须在 OpenClaw 网关启动后再做,否则保存会失败。 先做第五、六步,回来再做这一步也可以。
im.message.receive_v1(接收消息),勾选添加在应用的 凭证与基础信息 页面,复制:
cli_xxxxxxxxx)❗ App Secret 很重要,请妥善保管,不要分享。
OpenClaw ≥ 2026.2 已内置飞书插件,不需要额外安装,直接配置即可。
💡 如果你在首次
openclaw setup时看到 "Install Feishu plugin?",选择 "Download from npm" 即可进入配置流程。选了 "Skip" 也没关系,用下面的命令随时添加。
打开 终端(Terminal):
# 1. 添加飞书渠道(交互式,跟着提示走)
openclaw channels add
# 选择 Feishu → 粘贴 App ID → 粘贴 App Secret
# 2. 重启网关
openclaw gateway restart
# 3. 查看日志,确认连接成功
openclaw logs --follow
openclaw pairing approve feishu <配对码>
回来补第四步:如果你先跳过了事件订阅,现在网关已启动,回到飞书开放平台把第四步做完,保存后重启网关(
openclaw gateway restart)。
openclaw gateway install
这样电脑重启后机器人也会自动上线。
适用于:之前使用本项目(独立桥接或 npm 插件)的老用户。 两种方式任选其一,效果一样。
如果你的 OpenClaw 版本 ≥ 2026.2,升级后官方飞书插件已经内置,只需要:
openclaw update
升级完成后会自动重启网关。
openclaw channels add
选择 Feishu → 粘贴你的 App ID → 粘贴你的 App Secret。
App ID 和 App Secret 在哪?之前可能保存在
~/.clawdbot/secrets/feishu_app_secret,可以cat查看。 如果找不到,去 飞书开放平台 → 你的应用 → 凭证与基础信息 重新复制。
官方插件支持图片、文件、流式输出等更多功能,需要在飞书开放平台补几个权限:
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": [
"aily:file:read",
"aily:file:write",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
已有的权限会自动跳过,不会重复添加。
# 移除旧的 npm 插件(如果装过)
openclaw plugins remove feishu-openclaw 2>/dev/null
# 停掉旧的桥接服务(如果用过独立桥接)
launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist 2>/dev/null
# 重启网关
openclaw gateway restart
然后跳到下方 验证 确认一切正常。
适用于不想整体升级 OpenClaw、只想加飞书的情况。
注意:OpenClaw ≥ 2026.2 已内置飞书插件,不需要
openclaw plugins install。直接配置即可。
cli_xxxxxxxxx之前可能保存在
~/.clawdbot/secrets/feishu_app_secret,可以cat查看。 如果找不到,去 飞书开放平台 → 你的应用 → 凭证与基础信息 重新复制。
(同方式一的第 3 步,权限 JSON 一样,这里不重复粘贴——往上翻到方式一的权限 JSON 复制即可。)
# 添加飞书渠道(交互式引导)
openclaw channels add
# → 选择 Feishu
# → 粘贴 App ID
# → 粘贴 App Secret
# 移除旧的 npm 插件(如果装过)
openclaw plugins remove feishu-openclaw 2>/dev/null
# 停掉旧的桥接服务(如果用过独立桥接)
launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist 2>/dev/null
# 重启网关
openclaw gateway restart
# 查看日志,确认飞书连接成功
openclaw logs --follow
日志中看到类似 feishu ws connected 或 feishu provider ready 就说明连上了。
在飞书里给机器人发一条消息,正常收到回复 = 迁移完成 🎉
配对授权:如果机器人回复了一个配对码,在终端运行:
openclaw pairing approve feishu <配对码>授权后就能正常对话了。这是一次性操作。
稳定运行几天后,可以清理旧文件:
# 删除旧的 launchd 配置(桥接用户)
rm -f ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist
# 旧的桥接项目文件夹可以归档或删除
# (建议先保留一段时间,确认没问题再删)
如果你正在使用 OpenClaw 内置插件,想切换到飞书官方插件:
如果想切回内置插件:卸载官方插件后重启网关,内置插件会自动恢复。
遇到问题先看这里。如果没找到答案,欢迎开 Issue。
这是因为事件订阅没有配置。JSON 批量导入权限不会自动配置事件订阅,需要手动添加:
im.message.receive_v1(接收消息 v2.0)⚠️ 配置事件订阅前,确保 OpenClaw Gateway 已启动,否则长连接验证会失败。
按顺序检查:
网关在运行吗?
openclaw gateway status
如果没运行:openclaw gateway restart
飞书应用发布了吗? 去飞书开放平台 → 你的应用 → 版本管理,确认有已发布的版本
事件订阅配置了吗?
im.message.receive_v1权限够吗?
至少需要:im:message、im:message.p2p_msg:readonly、`im:message:sen