摘要:本文详细记录使用 OpenClaw 连接飞书机器人的全过程,包括插件安装失败、配置错误等常见问题的解决方案。
最近在使用 OpenClaw 连接飞书机器人时遇到了一系列问题,网上相关资料较少,特此记录完整解决方案,帮助有同样需求的同学少走弯路。
- OpenClaw 版本: latest
- Node.js: v22.22.0
- 操作系统: Windows 11
- 飞书应用类型: 企业内部应用
现象
按照文档尝试安装飞书插件:
GPT plus 代充 只需 145
错误信息:
讯享网
原因分析
OpenClaw 官方 npm 仓库中并没有发布 包,文档中提到的飞书插件需要单独安装。
解决方案
使用第三方开源插件:
验证安装:
讯享网
看到列表中有 即表示安装成功。
遇到这种情况只要把事件配置里的订阅方式长连接配置好,再发布就可以了
现象
插件安装成功后,配置了 App ID 和 App Secret,但发送消息时报错:
飞书机器人聊天窗口也没有任何响应。
错误配置示例 ❌
最初我这样配置:
讯享网
原因分析
- 域名错误:飞书(Feishu)和 Lark 是字节跳动不同版本的产品
- 飞书(中国版):
- Lark(国际版):
- 配置结构错误:插件需要 数组格式,而不是顶层配置
正确的配置方式 ✅
第一步:配置 accounts 数组
第二步:配置 channels 引用
讯享网
第三步:重启 Gateway
必要权限
在飞书开放平台(open.feishu.cn/app)需要开启以下权限:
- 机器人权限
- ✅ 机器人: 获取以应用身份发送的消息
- ✅ 机器人: 在群组内发送和接受消息
- 即时消息权限
- ✅ 即时消息: 发送消息
- 群组权限
- ✅ 群组: 获取群组信息
配置步骤
- 进入飞书开放平台 → 我的应用
- 点击 权限管理
- 搜索并添加上述权限
- 点击 申请权限 并提交
- 等待审核通过(企业应用通常自动通过)
讯享网
获取群聊 ID
从飞书群链接中提取:
群 ID 为:
发送消息命令
讯享网
或者在代码中调用:
问题 原因 解决方案 插件安装 404 官方包未发布 使用 GitHub 第三方插件 account not configured 配置结构错误 使用 数组格式 Invalid App Access Token 域名错误 设为 不是 消息发送失败 权限未开启 在飞书开放平台申请必要权限 配置不生效 未重启 gateway
连接飞书的关键点:
- ✅ 使用正确的插件来源(GitHub 第三方插件)
- ✅ 配置正确的数据结构( 数组格式)
- ✅ 区分飞书和 Lark 的域名配置
- ✅ 确保飞书应用有足够权限
- ✅ 每次配置修改后重启 gateway
希望这篇文章能帮助你少走弯路!如果有问题欢迎在评论区交流。
- OpenClaw 官方文档
- 飞书开放平台
- openclaw-feishu 插件源码
- 飞书 API 文档
标签: #OpenClaw #飞书 #机器人 #自动化 #Node.js

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/212157.html