问题描述

升级 OpenClaw 至 2026.3.23 后,执行 openclaw doctor --fix 出现以下错误:

ERROR: plugin path not found: D:\devTools\Node.js\node_global\node_modules\openclaw\extensions\feishu
WARN: duplicate plugin id detected; bundled plugin will be overridden by global plugin
Error: Config validation failed: plugins.load.paths: plugin: plugin path not found

问题原因

升级后全局安装的 OpenClaw 路径发生变化,但配置文件 ~/.openclaw/openclaw.json 中仍引用旧的全局插件路径,导致配置验证失败。


修复步骤

1 打开配置文件

用文本编辑器打开:

C:\Users\Administrator\.openclaw\openclaw.json

2 找到 plugins 配置

在文件中搜索 "plugins",找到类似以下的配置段:

"plugins": {
  "load": {
    "paths": [
      "D:\\devTools\\Node.js\\node_global\\node_modules\\openclaw\\extensions\\feishu"
    ]
  },
  "entries": {
    "qwen-portal-auth": {
      "enabled": true
    },
    "feishu": {
      "enabled": true
    }
  },
  "installs": {
    "feishu": {
      "source": "npm",
      "spec": "@openclaw/feishu",
      "installPath": "C:\\Users\\Administrator\\.openclaw\\extensions\\feishu",
      "version": "2026.3.2"
    }
  }
}

3 删除 load.paths 字段

删除整个 "load" 字段,保留 "entries""installs"

修复前

"plugins": {
  "load": {
    "paths": [
      "D:\\devTools\\Node.js\\node_global\\node_modules\\openclaw\\extensions\\feishu"
    ]
  },
  "entries": { ... }
}

修复后

"plugins": {
  "entries": { ... }
}

4 保存并验证

保存文件后,重新运行:

openclaw doctor --fix

应该不再报 plugin path not found 错误。


原理说明

插件路径类型 路径示例 说明
全局安装 D:\devTools\Node.js\node_global\node_modules\openclaw\extensions\ 随 OpenClaw 升级可能变化
用户安装 C:\Users\Administrator\.openclaw\extensions\ 推荐,不受升级影响

删除 load.paths 后,系统会自动使用用户目录下已安装的插件,避免路径失效问题。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐