aionclaw插件冲突90%是同一插件多副本或plugin.id重复所致;需先用openclaw status --deep确认多个feishu条目及路径差异,再按停止服务→删插件目录→清缓存→查node_modules→重启前验证的顺序清理,禁止单纯改plugin.id以免渠道注册失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

直接结论:AionClaw 提示插件冲突,90% 是同一插件被加载了多个副本,或 plugin.id 值重复。不是版本不兼容,也不是配置写错,而是系统在扫描时撞见了两个“都叫 feishu”的插件。
确认冲突插件的 ID 和路径
先别删文件,用命令把实际加载情况打出来:
openclaw status --deep
重点关注输出里 plugins 部分,看是否出现多个 feishu 条目,以及它们的 path 字段是否指向不同位置。常见组合包括:
-
/opt/openclaw/plugins/feishu/main.so(官方插件) -
/node_modules/@aionclaw/plugin-feishu/main.so(npm 安装残留) -
~/.openclaw/cache/plugins/feishu-2.1.0/main.so(缓存未清理)
只要看到两个以上 plugin.id: "feishu" 的条目,就坐实了冲突。
清理重复插件的实操顺序
必须按这个顺序操作,跳步容易漏掉隐性副本:
- 停止服务:
openclaw stop - 删除所有插件目录下的
feishu子目录:rm -rf /opt/openclaw/plugins/feishu - 清空缓存:
rm -rf ~/.openclaw/cache/plugins/feishu* - 检查 node_modules:
find . -name "@aionclaw/plugin-feishu" -type d,如果存在,rm -rf掉整行路径 - 重启前验证:
openclaw doctor应该不再报duplicate plugin id detected
为什么改 plugin.id 不是首选方案
有人想手动改 manifest 里的 "plugin.id": "feishu" 成 "feishu-v2" 来绕过检测——这会导致渠道注册失败,因为 channels.yaml 里写的仍是 feishu,系统找不到对应插件实例。更麻烦的是,飞书回调地址、签名验证逻辑都硬编码依赖原始 ID,改 ID 后即使启动成功,消息也收不到、发不出。
真正要改 ID 的唯一场景是:你正在开发一个**完全独立的飞书替代插件**,且明确不走 OpenClaw 原生飞书渠道链路。普通用户不该碰这个字段。
重装插件时最容易忽略的点
AionClaw 插件安装后默认会写入 plugins.yaml,但如果你之前手动编辑过这个文件,重装时它不会自动覆盖旧路径。务必检查:
-
plugins.yaml中feishu.path是否指向当前有效的.so文件 - 路径是否用了相对路径(如
./plugins/feishu/main.so),应改为绝对路径 - 文件权限是否为
-rwxr-xr-x,属主是否与运行openclaw的用户一致
权限不对或路径失效,openclaw doctor 会报 plugin path not found,但它和 ID 冲突是两回事,别混在一起处理。











