feishu-openclaw
v0.3.1
Published
飞书机器人插件 - 让 AI 助手接入飞书,无需服务器 | Feishu/Lark channel plugin for Clawdbot / OpenClaw
Maintainers
Readme
feishu-openclaw
v0.2.0 — 支持 OpenClaw 和 Clawdbot 双环境
飞书 × AI 助手插件 — 无需服务器,WebSocket 长连接
Feishu × AI Assistant plugin — no server required, WebSocket long-connection
⚠️ 安装前必做(约 5 分钟)
1. 创建飞书机器人
- 飞书开放平台 → 创建企业自建应用
- 添加「机器人」能力
- 权限配置 → 开启:
im:messageim:message.group_at_msgim:message.p2p_msg
- 版本管理 → 创建版本 → 发布上线
- 记下 App ID (
cli_xxx) 和 App Secret
2. ⚠️ 事件订阅:必须先配好 App ID/Secret
飞书要求先验证 App ID/Secret 才能配置「长连接」,所以顺序是:
先安装插件 → 配置 App ID/Secret → 重启 Gateway → 再去飞书开放平台配置长连接📦 安装
OpenClaw
openclaw plugins install feishu-openclawClawdbot
clawdbot plugins install feishu-openclaw🔧 配置
1. 配置 App ID 和 App Secret
OpenClaw:
openclaw config set channels.feishu.enabled true --json
openclaw config set channels.feishu.appId "cli_你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
openclaw gateway restartClawdbot:
clawdbot config set channels.feishu.enabled true --json
clawdbot config set channels.feishu.appId "cli_你的AppID"
clawdbot config set channels.feishu.appSecret "你的AppSecret"
clawdbot gateway restart2. 配置飞书事件订阅
Gateway 重启后,再去飞书开放平台:
- 事件与回调 → 添加
im.message.receive_v1 - 订阅方式 → 选择 「使用长连接接收事件」 ⚠️ 不是 Webhook!
- 保存
3. 验证
openclaw status # 或 clawdbot status应该看到:
│ Feishu │ ON │ OK │ configured │❗ 常见问题
收不到消息?
| 检查项 | 说明 | |--------|------| | 应用已发布 | 不能是草稿状态 | | 用「长连接」 | 不是 Webhook | | 权限已开启 | 三个 im 权限都要开 |
报错 unknown channel id: feishu?
这是 doctor 检查的 warning,不影响实际运行。只要 openclaw status 显示 Feishu: ON | OK 就是正常的。
群聊不回复?
@机器人,或消息末尾加问号。
特点
- ✅ 无需服务器 — WebSocket 长连接,穿透 NAT
- ✅ 双环境支持 — OpenClaw 和 Clawdbot
- ✅ 私聊 + 群聊 — 支持 @mention
- ✅ 图片文件收发
- ✅ 多账号支持
链接
License
MIT
