OpenClaw连接飞书插件安装、配置与踩坑记录完整指南
前言
最近在使用 OpenClaw 连接飞书机器人时遇到了一系列问题,网上相关资料较少,特此记录完整解决方案,帮助有同样需求的同学少走弯路。
环境信息
- OpenClaw 版本: latest
- Node.js: v22.22.0
- 操作系统: Windows 11
- 飞书应用类型: 企业内部应用
问题一:官方飞书插件安装失败
现象
按照文档尝试安装飞书插件:
openclaw plugins install feishu
错误信息:
Error: Cannot find package '@openclaw/plugin-feishu' npm ERR! 404 Not Found
原因分析
OpenClaw 官方 npm 仓库中并没有发布 @openclaw/plugin-feishu 包,文档中提到的飞书插件需要单独安装。
解决方案
使用第三方开源插件:
openclaw plugins install https://github.com/AlexAnys/openclaw-feishu
验证安装:
openclaw plugins list
看到列表中有 feishu 即表示安装成功。
问题二:配置后机器人后机器人聊天口没有

遇到这种情况只要把事件配置里的订阅方式长连接配置好,再发布就可以了
现象
插件安装成功后,配置了 App ID 和 App Secret,但发送消息时报错:
Feishu account 'default' not configured
飞书机器人聊天窗口也没有任何响应。
错误配置示例 ❌
最初我这样配置:
openclaw config set channels.feishu.app_id "cli_xxx" openclaw config set channels.feishu.app_secret "xxx" openclaw config set channels.feishu.domain "lark" # 错误!应该是 feishu
原因分析
域名错误:飞书(Feishu)和 Lark 是字节跳动不同版本的产品
- 飞书(中国版):
domain = "feishu" - Lark(国际版):
domain = "lark"
- 飞书(中国版):
配置结构错误:插件需要
accounts数组格式,而不是顶层配置
正确的配置方式 ✅
第一步:配置 accounts 数组
# 配置账号 ID openclaw config set "accounts.feishu[0].id" "default" # 配置 App ID openclaw config set "accounts.feishu[0].app_id" "cli_xxx" # 配置 App Secret openclaw config set "accounts.feishu[0].app_secret" "xxx"
第二步:配置 channels 引用
# 配置域名(注意是 feishu 不是 lark) openclaw config set "channels.feishu.accounts[0].domain" "feishu" # 配置账号引用 openclaw config set "channels.feishu.account" "default"
第三步:重启 Gateway
openclaw gateway restart
问题三:飞书应用权限配置
必要权限
在飞书开放平台(open.feishu.cn/app)需要开启以下权限:
机器人权限
- ✅ 机器人: 获取以应用身份发送的消息
- ✅ 机器人: 在群组内发送和接受消息
即时消息权限
- ✅ 即时消息: 发送消息
群组权限
- ✅ 群组: 获取群组信息
配置步骤
- 进入飞书开放平台 → 我的应用
- 点击 权限管理
- 搜索并添加上述权限
- 点击 申请权限 并提交
- 等待审核通过(企业应用通常自动通过)
最终完整配置
{
"accounts": {
"feishu": [
{
"id": "default",
"app_id": "cli_xxx",
"app_secret": "xxx"
}
]
},
"channels": {
"feishu": {
"account": "default",
"accounts": [
{
"id": "default",
"domain": "feishu",
"app_id": "cli_xxx",
"app_secret": "xxx"
}
]
}
}
}测试发送消息
获取群聊 ID
从飞书群链接中提取:
https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=f7ftd1a0-50db-46b7-8e86-40a7b731a10a
群 ID 为:f7ftd1a0-50db-46b7-8e86-40a7b731a10a
发送消息命令
openclaw message send \ --channel feishu \ --target "chat:f7ftd1a0-50db-46b7-8e86-40a7b731a10a" \ --message "大家好,这是测试消息!"
或者在代码中调用:
await message.send({
channel: 'feishu',
target: 'chat:f7ftd1a0-50db-46b7-8e86-40a7b731a10a',
message: '大家好'
});常见问题汇总
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 插件安装 404 | 官方包未发布 | 使用 GitHub 第三方插件 |
| account not configured | 配置结构错误 | 使用 accounts.feishu[0] 数组格式 |
| Invalid App Access Token | 域名错误 | domain 设为 "feishu" 不是 "lark" |
| 消息发送失败 | 权限未开启 | 在飞书开放平台申请必要权限 |
| 配置不生效 | 未重启 gateway | openclaw gateway restart |
总结
连接飞书的关键点:
- ✅ 使用正确的插件来源(GitHub 第三方插件)
- ✅ 配置正确的数据结构(
accounts数组格式) - ✅ 区分飞书和 Lark 的域名配置
- ✅ 确保飞书应用有足够权限
- ✅ 每次配置修改后重启 gateway
希望这篇文章能帮助你少走弯路!如果有问题欢迎在评论区交流。
参考链接
到此这篇关于OpenClaw连接飞书插件安装、配置与踩坑记录的文章就介绍到这了,更多相关OpenClaw连接飞书内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
相关文章
OpenClaw 是一个个人 AI 代理框架,支持连接多种聊天平台(如飞书、Telegram 等)并集成多种模型,这篇文章主要介绍了OpenClaw飞书官方插件安装教程的相关资料,文中通过代码2026-03-27
ubuntu (V100)中 部署openclaw并链接飞书的操作方法
本文介绍了在Ubuntu上部署Ollama的大模型推理框架及OpenClaw的方法,包括编译安装Ollama、使用OpenClaw的安装脚本和配置文件等步骤,并简要介绍了OpenClaw的工作流程,感兴趣2026-03-26
OpenClaw 的 ACP机制允许将 Codex、Claude Code、Gemini CLI 等外部编程工具纳入 OpenClaw 的 Agent 编排体系,很多读者在飞书渠道部署 OpenClaw 后,想知道如何在这个环境2026-03-26
当你的 AI 助手突然聋了——能发消息却收不到回复,问题可能藏在一个你根本不会去看的 .ts 文件里,下面小编就和大家详细介绍一下OpenClaw飞书插件加载失败的问题排查与解决2026-03-25
OpenClaw多渠道接入WhatsApp、Telegram、飞书的实战指南
OpenClaw的Channels多渠道接入系统是其六层架构的第一层,负责连接外部消息平台与AI Agent系统,本文深入剖析Channels的核心概念、架构设计、与Gateway的交互机制,详细介绍2026-03-23
最近在使用 OpenClaw 进行飞书机器人配对时,执行命令时遇到了错误,同时启动日志中反复出现警告这个问题的根本原因是 OpenClaw 环境中存在两个 ID 相同的飞书插件,本文借2026-03-19
OpenClaw解决飞书 duplicate plugin id detected 问题
文章介绍了OpenClaw在启动过程中检测到重复的feishu插件ID并导致冲突的问题,通过查找和删除全局插件文件并调整配置文件,成功解决了这个问题,感兴趣的朋友跟随小编一起看看2026-03-17
在Ubuntu上快速部署OpenClaw并接入飞书的完整过程
OpenClaw是一个可扩展的 AI 助手运行框架,核心目标是让助手真正“能做事”,这篇文章主要介绍了在Ubuntu上快速部署OpenClaw并接入飞书的完整过程,文中通过图文介绍的非常详2026-03-13
本文详细介绍如何将OpenClaw AI 智能体网关与飞书(Feishu)集成,实现企业内部的 AI 助手功能,涵盖飞书应用创建、权限配置、OpenClaw 连接和高级功能设置,本文给大家介绍2026-03-17
OpenClaw 从零配置指南并接入飞书 + 常用命令 + 原理全解析
本文介绍了如何从零配置OpenClaw并接入飞书,包括安装、配置、权限设置、模型切换、技能管理等步骤,以及常用命令和配置文件说明,感兴趣的朋友跟随小编一起看看吧2026-03-12












最新评论