飞书 gateway 启动时 duplicate plugin 警告的根因与处理

问题描述

openclaw gateway start 之后，日志里出现：

[warn] Duplicate plugin detected: feishu
Plugin 'feishu' is being loaded multiple times. Only the first instance will be used.

飞书消息能收、能发，一切功能正常——但这个警告每次启动都有，看着烦。

根因分析

同一个飞书插件被加载了两次：

1. 自动加载：extensions/openclaw-lark/ 目录存在时，OpenClaw 会自动扫描并加载

2. 显式声明：openclaw.json 里有手动写的 feishu 插件 entry

两条路都触发，调度器发现重复，用第一个（自动加载的那个），忽略第二个，但会打一条警告。

这种情况通常发生在：先手动配了 feishu 插件，后来又装了 openclaw-lark 扩展，没有清理旧配置。

判断是否影响功能

# 检查飞书消息收发是否正常

openclawctl test-plugin feishu
# 或者直接在聊天窗口发条消息，看 gateway 日志有没有正常处理
tail -f ~/.openclaw/logs/gateway.log | grep -E "feishu|plugin"

如果消息正常收发，日志里只有 [warn] 没有 [error]，说明功能完全不受影响。只是警告，不是错误。

消除警告的方法

找到 openclaw.json，删掉显式的 feishu 插件声明：

# 备份
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
# 查看当前配置
cat ~/.openclaw/openclaw.json | jq '.plugins'

Before：

{
  "plugins": [
    { "name": "feishu", "appId": "cli_xxx", "appSecret": "xxx" },
    { "name": "other-plugin" }
  ]
}

After：

{
  "plugins": [
    { "name": "other-plugin" }
  ]
}

删掉之后，重启 gateway，警告消失。飞书插件仍然通过 openclaw-lark 扩展正常工作。

什么情况下不要动

如果满足以下任一条件，建议不要删，保持现状：

• 你不确定显式声明和扩展加载用的是同一个 AppID
• 飞书功能目前正常，你怕改了之后出问题
• 警告只在 debug 级别日志里出现，info 级别看不到

警告本身无害。功能正常时，消除警告属于「洁癖优化」，不是必须做的事。

预防建议

安装新扩展后，检查是否和现有手动配置有重叠：

# 列出所有已加载的插件

openclawctl list-plugins
# 和 openclaw.json 里的声明对比
cat ~/.openclaw/openclaw.json | jq '.plugins[].name'

有重叠就选一种加载方式，不要两者共存。