OpenClaw 飞书插件冲突plugins.entries.feishu: plugin feishu: duplicate plugin id detected解决方案

环境信息

• • OpenClaw 版本: 2026.2 或更高版本
• • 操作系统: Ubuntu / Linux
• • 涉及插件: Feishu（飞书）
• • 问题类型: 插件ID重复冲突

一、问题现象

在启动 OpenClaw 或执行相关命令时，控制台出现如下警告信息：

Config warnings:
- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; 
  later plugin may be overridden (/home/ubuntu/.openclaw/extensions/feishu/index.ts)

这直接表明：系统检测到了重复的 feishu 插件ID。

二、原因分析

2.1 内置插件存在

OpenClaw 2026.2 及更高版本 已将飞书插件内置到系统核心中，无需手动安装即可直接使用。

2.2 手动安装冲突

如果您曾在以下路径手动安装过飞书插件：

~/.openclaw/extensions/feishu/

这将导致系统中同时存在两个同名插件：

• • ✅ 内置插件：OpenClaw 核心自带
• • ❌ 用户插件：手动安装的副本

系统加载时会检测到重复的 plugin id，从而触发警告。

2.3 配置路径错误

您可能尝试使用以下命令设置配置：

# ❌ 错误路径
openclaw config set feishu.appId "xxx"

但正确的配置路径应该是：

# ✅ 正确路径
openclaw config set channels.feishu.appId "xxx"

三、解决方案

3.1 删除用户目录下的冲突插件（推荐）

这是最直接、最安全的解决方法。删除手动安装的插件副本，让系统只使用内置插件。

rm -rf ~/.openclaw/extensions/feishu

⚠️ 注意：此操作会删除 ~/.openclaw/extensions/ 目录下的 feishu 文件夹，不会影响内置插件功能。

3.2 重启OpenClaw网关

删除插件后，必须重启网关使配置生效：

openclaw gateway restart

重启后，系统将只加载内置的飞书插件，重复ID警告将彻底消失。

3.3 使用正确的配置命令

删除冲突插件后，使用正确的配置路径设置飞书应用凭证：

# 设置飞书 App ID
openclaw config set channels.feishu.appId "你的AppID"

# 设置飞书 App Secret
openclaw config set channels.feishu.appSecret "你的AppSecret"

四、验证修复

执行以下步骤验证问题是否解决：

1. 1. 检查警告是否消失

   openclaw gateway logs
   

   确认启动日志中不再出现 duplicate plugin id detected 警告。

2. 2. 验证插件加载状态

   openclaw plugins list
   

   确认 feishu 插件状态为 active，且路径指向内置目录（非 ~/.openclaw/extensions）。

3. 3. 测试飞书功能发送测试消息，确认飞书渠道正常工作。

五、总结

核心要点：OpenClaw 2026.2+ 已内置飞书插件，无需手动安装。遇到重复ID警告时，优先清理用户目录下的旧插件。

六、常见问题

Q1: 删除 ~/.openclaw/extensions/feishu 会影响数据吗？

不会。该目录仅包含插件代码，不包含配置数据或聊天记录。配置存储在独立的数据库中。

Q2: 如何确认使用的是内置插件还是手动插件？

执行 openclaw plugins list，查看 feishu 插件的 path 字段。如果路径包含 node_modules/@openclaw/ 或系统目录，则为内置插件；如果包含 ~/.openclaw/extensions/，则为手动插件。

Q3: 我想使用自定义修改的飞书插件怎么办？

如需覆盖内置插件，可以：

1. 1. 修改 ~/.openclaw/extensions/feishu/ 下的代码
2. 2. 在配置中显式指定插件优先级
3. 3. 或重命名插件ID以避免冲突