openclaw日志提示"plugin not found"解决

Posted on Views:

异常日常

Config warnings:\n- plugins.entries.@openclaw/feishu: plugin not found: @openclaw/feishu (stale config entry ignored; remove it from plugins config)
...

1.这条告警是什么意思

这不是 OpenClaw 主程序崩了，而是配置里还残留了一个插件声明：

残留

1
plugins.entries.@openclaw/feishu

但当前运行环境里，OpenClaw 没有找到这个插件包，所以给出告警：

1
2
plugin not found: @openclaw/feishu
(stale config entry ignored; remove it from plugins config)

2.本质原因

常见成因有这几类：

2.1 旧版本配置遗留

升级 OpenClaw 后，老的 openclaw.json / 插件配置仍然保留了：

1
plugins.entries.@openclaw/feishu

但新版本已经不再按这个名字解析，或者已经改成内置扩展，因此出现“配置里有，运行时找不到”。

2.2 插件命名/加载方式发生变化

社区里近期关于 Feishu 的问题很多都和以下情况相关：

  • 旧插件名已失效
  • 官方已内置 bundled plugin，不该再手工安装一遍
  • 自动同步配置或安装脚本写入了过期 entry，导致启动时警告

3.怎么处理

3.1 先清理过期配置项

到你的 OpenClaw 配置文件里，删除 Feishu 的旧 entry

1
plugins.entries.@openclaw/feishu

手动移除 stale entry 后重启 gateway 是首要处理动作。

# vim ~/.openclaw/openclaw.json
...
  "plugins": {
    "entries": {
      "duckduckgo": {
        "enabled": false
      },
      "tavily": {
        "enabled": true,
        "config": {
          "webSearch": {
            "apiKey": "${TAVILY_API_KEY}"
          }
        }
      },
      "openclaw-qqbot": {
        "enabled": true
      },
//删掉
      "@openclaw/feishu": {
        "enabled": true
      }
    },
...

openclaw gateway restart
openclaw logs --follow