openclaw - 💡(How to fix) Fix 升级版本后配置文件中的插件路径未更新,导致 gateway 启动失败 [1 comments, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#58626Fetched 2026-04-08 02:00:00
View on GitHub
Comments
1
Participants
1
Timeline
1
Reactions
0
Author
Participants
Timeline (top)
subscribed ×1

Code Example

Config invalid
File: ~/.openclaw/openclaw.json
Problem:
  - plugins.load.paths: plugin: plugin path not found: /Users/link/Library/pnpm/global/5/.pnpm/openclaw@2026.3.28_@napi-rs+canvas@0.1.97/node_modules/openclaw/dist/extensions/acpx

---

"plugins": {
     "load": {
       "paths": ["/Users/.../[email protected]_@[email protected]/.../acpx"]
     },
     "installs": {
       "acpx": {
         "sourcePath": "/Users/.../[email protected]_@[email protected]/.../acpx",
         "installPath": "/Users/.../[email protected]_@[email protected]/.../acpx"
       }
     }
   }
RAW_BUFFERClick to expand / collapse

问题描述

每次升级 openclaw 版本后,运行 openclaw gateway start 会失败,报错:

Config invalid
File: ~/.openclaw/openclaw.json
Problem:
  - plugins.load.paths: plugin: plugin path not found: /Users/link/Library/pnpm/global/5/.pnpm/[email protected]_@[email protected]/node_modules/openclaw/dist/extensions/acpx

根本原因

  1. 配置文件 (~/.openclaw/openclaw.json) 中存储了带版本号的绝对路径:

    "plugins": {
      "load": {
        "paths": ["/Users/.../[email protected]_@[email protected]/.../acpx"]
      },
      "installs": {
        "acpx": {
          "sourcePath": "/Users/.../[email protected]_@[email protected]/.../acpx",
          "installPath": "/Users/.../[email protected]_@[email protected]/.../acpx"
        }
      }
    }
  2. pnpm 升级时会删除旧版本目录,只保留新版本

  3. 升级后,配置文件中的路径指向已不存在的旧版本目录

  4. openclaw doctor --fix 没有检测或修复这个路径问题

期望行为

  • 方案 A:升级时自动更新配置文件中的版本相关路径
  • 方案 B:doctor --fix 能检测并修复过期的路径
  • 方案 C:使用相对路径或版本无关的路径设计(如符号链接)

当前解决方案

手动修改配置文件,将旧版本号替换为新版本号。

环境信息

  • openclaw 版本:2026.3.31(从 2026.3.28 升级)
  • 安装方式:pnpm global
  • 操作系统:macOS

extent analysis

TL;DR

Update the ~/.openclaw/openclaw.json configuration file to use relative paths or version-agnostic paths to resolve the plugin path not found error after upgrading openclaw.

Guidance

  • Verify the ~/.openclaw/openclaw.json file contains absolute paths with version numbers and update them to relative paths or version-agnostic paths.
  • Consider using symbolic links to point to the latest version of plugins.
  • Run openclaw doctor --fix after updating the configuration file to ensure any other potential issues are addressed.
  • If using relative paths, ensure the plugin directories are correctly referenced relative to the configuration file.

Example

"plugins": {
  "load": {
    "paths": ["../extensions/acpx"]
  },
  "installs": {
    "acpx": {
      "sourcePath": "../extensions/acpx",
      "installPath": "../extensions/acpx"
    }
  }
}

Notes

The current solution requires manual modification of the configuration file after each upgrade, which may be prone to errors. A more robust solution would involve automating the update of the configuration file during the upgrade process or using version-agnostic paths.

Recommendation

Apply workaround by updating the configuration file to use relative paths or version-agnostic paths, as this is a more immediate solution to the problem, although it may require manual intervention after each upgrade.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix 升级版本后配置文件中的插件路径未更新,导致 gateway 启动失败 [1 comments, 1 participants]