OpenClaw Feishu 插件重复注册警告 - 问题记录与解决方案

记录时间: 2026-03-01
涉及版本: OpenClaw 2026.2.6-3

⚠️ 警告现象

执行 OpenClaw 命令时出现以下警告：

Config warnings:
- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; 
  later plugin may be overridden (C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\extensions\feishu\index.ts)

此警告在每次执行命令（如 openclaw status、openclaw config 等）时都会出现。

🔍 问题原因

Feishu 插件被重复注册了两次，OpenClaw 从两个不同的位置加载了同一个插件：

当 OpenClaw 加载插件时，同时从系统扩展目录和用户扩展目录查找并加载 feishu 插件，导致同一个插件 ID 被注册两次，触发冲突警告。

✅ 解决方案

方法：删除用户级的重复扩展目录

由于系统级扩展已经足够使用，删除用户目录下的重复扩展：

PowerShell 命令：

Remove-Item -Recurse -Force C:\Users\Administrator\.openclaw\extensions\feishu

CMD 命令：

rmdir /s /q C:\Users\Administrator\.openclaw\extensions\feishu

步骤

1. 执行删除命令（使用管理员权限的终端）
2. 重启 Gateway 使更改生效：
   bash openclaw gateway restart
3. 验证警告已消除：
   bash openclaw status

📝 相关配置说明

配置层级

OpenClaw 的配置有几个层级，与插件相关的配置位置：

1. 全局配置: C:\Users\Administrator\.openclaw\openclaw.json
2. channels.feishu - 启用 Feishu 频道

3. plugins.entries - 手动启用插件（已移除重复的 feishu 配置）

4. Agent 级配置: C:\Users\Administrator\.openclaw\agents\main\agent\

5. models.json - 模型配置
6. auth-profiles.json - API Key 配置

扩展目录

• 系统扩展: C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\extensions\
• 用户扩展: C:\Users\Administrator\.openclaw\extensions\ ← 注意：通常不需要在这里放扩展

✅ 验证结果

执行 openclaw status 后，输出中不再出现重复插件警告：

[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive_tools
[plugins] feishu_bitable: Registered 6 bitable tools
OpenClaw status
...

所有 Feishu 功能正常工作：
- ✅ Feishu 频道消息收发
- ✅ Feishu 文档操作
- ✅ Feishu 云空间操作
- ✅ Feishu 多维表格操作

💡 预防措施

1. 安装扩展时：优先使用系统级扩展，避免在用户目录下放置重复的扩展
2. 配置插件时：使用 channels.feishu 启用 Feishu，无需在 plugins.entries 中重复配置
3. 遇到警告时：检查 openclaw config get plugins 查看插件配置

📚 参考命令

# 查看当前插件配置
openclaw config get plugins

# 查看当前状态
openclaw status

# 重启 Gateway
openclaw gateway restart

# 查看 Feishu 工具是否加载
openclaw tools list | findstr feishu

文档由 LISA （openclaw AI助理）生成