升级OpenClaw失败、重装卡死、丢失node模块等问题处理

1、openclaw update升级失败

(base) root@aitrainer:~/.openclaw# openclaw update
Updating OpenClaw...
◇  ✗ Updating via package manager (1200.04s)
◇  ✗ Running doctor checks (27ms)
        at ModuleLoader.resolveSync (node:internal/modules/esm/loader:765:52)
        at #resolve (node:internal/modules/esm/loader:701:17)
        at ModuleLoader.getOrCreateModuleJob (node:internal/modules/esm/loader:621:35)
        at ModuleJob.syncLink (node:internal/modules/esm/module_job:160:33)
        at ModuleJob.link (node:internal/modules/esm/module_job:245:17) {
      code: 'ERR_MODULE_NOT_FOUND',
      url: 'file:///usr/lib/node_modules/openclaw/dist/is-main-YViS6wOn.js'
    }
    Node.js v24.14.1
Update Result: ERROR
  Root: /usr/lib/node_modules/openclaw
  Reason: global update
  Before: 2026.4.2
Total time: 1200.36s
(base) root@aitrainer:~/.openclaw# openclaw -v
-bash: /usr/bin/openclaw: No such file or directory
(base) root@aitrainer:~/.openclaw#

2、输入openclaw命令如下提示

(base) root@aitrainer:~# openclaw
openclaw: command not found

3、查询doubao，答复需要重装，清除之前的残余重装。

npm uninstall -g openclaw
npm cache clean --force
npm install -g openclaw@latest
openclaw -v

4、上述安装步骤中，执行时间超过10分钟，于是Ctrl+C，采用下面的方法安装

# 清理残留进程 
pkill -f node 
pkill -f npm 
# 强制删除损坏的安装文件 
rm -rf /usr/lib/node_modules/openclaw
rm -rf /usr/bin/openclaw
# 清理缓存 + 极速重新安装
npm cache clean --force 
npm install -g openclaw@latest –force

5、执行上述操作仍然超过10分钟，只看到转圈，无其它输出

root@aitrainer:~/.openclaw# npm install -g openclaw@latest –force
npm warn using --force Recommended protections disabled.
⠦ ⠼
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead 
⠋

6、在安装后期，另一个terminal下，执行openclaw -v有正常输出，但openclaw status大量报错：

(base) root@aitrainer:~# openclaw -v
OpenClaw 2026.4.5 (3e72c03)

openclaw status大量报错，核心错误是Cannot find module '@buape/carbon'：
(base) root@aitrainer:~# openclaw status
Failed to read config at /root/.openclaw/openclaw.json Error: Cannot find module '@buape/carbon'
Require stack:
- /usr/lib/node_modules/openclaw/dist/ui-7MjYF8PY.js
    at Module._resolveFilename (node:internal/modules/cjs/loader:1456:15)
    at require.resolve (node:internal/modules/helpers:163:19)
    at jitiResolve (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:148703)
    at jitiRequire (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:150290)
    at /usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:157987
    at /usr/lib/node_modules/openclaw/dist/ui-7MjYF8PY.js:14:15
    at eval_evalModule (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:155533)
    at jitiRequire (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:150967)
    at /usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:157987
    at /usr/lib/node_modules/openclaw/dist/channel-D0kY3Gd-.js:29:19 {
  code: 'MODULE_NOT_FOUND',
  requireStack: [ '/usr/lib/node_modules/openclaw/dist/ui-7MjYF8PY.js' ]
}
🦞 OpenClaw 2026.4.5 (3e72c03) — Less clicking, more shipping, fewer "where did that file go" moments.
Config invalid
File: ~/.openclaw/openclaw.json
Problem:
  - <root>: read failed: Error: Cannot find module '@buape/carbon'\nRequire stack:\n- /usr/lib/node_modules/openclaw/dist/ui-7MjYF8PY.js

Run: openclaw doctor --fix
Failed to read config at /root/.openclaw/openclaw.json Error: Cannot find module '@buape/carbon'
Require stack:
- /usr/lib/node_modules/openclaw/dist/ui-7MjYF8PY.js
    at Module._resolveFilename (node:internal/modules/cjs/loader:1456:15)
    at require.resolve (node:internal/modules/helpers:163:19)
    at jitiResolve (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:148703)
    at jitiRequire (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:150290)
    at /usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:157987
    at /usr/lib/node_modules/openclaw/dist/ui-7MjYF8PY.js:14:15
    at eval_evalModule (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:155533)
    at jitiRequire (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:150967)
    at /usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:157987
    at /usr/lib/node_modules/openclaw/dist/channel-D0kY3Gd-.js:29:19 {
  code: 'MODULE_NOT_FOUND',
  requireStack: [ '/usr/lib/node_modules/openclaw/dist/ui-7MjYF8PY.js' ]
}
[openclaw] Failed to start CLI: Error: Cannot find module '@buape/carbon'
Require stack:
- /usr/lib/node_modules/openclaw/dist/ui-7MjYF8PY.js
    at Module._resolveFilename (node:internal/modules/cjs/loader:1456:15)
    at require.resolve (node:internal/modules/helpers:163:19)
    at jitiResolve (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:148703)
    at jitiRequire (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:150290)
    at /usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:157987
    at /usr/lib/node_modules/openclaw/dist/ui-7MjYF8PY.js:14:15
    at eval_evalModule (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:155533)
    at jitiRequire (/usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:150967)
    at /usr/lib/node_modules/openclaw/node_modules/jiti/dist/jiti.cjs:1:157987
at /usr/lib/node_modules/openclaw/dist/channel-D0kY3Gd-.js:29:19

7、为了能看到安装过程卡在哪一步，于是Ctrl+C，执行以下

npm install -g openclaw@latest --foreground-scripts –verbose
代替：npm install -g openclaw@latest –force

能看到具体安装步骤和打印，发现最后停在：

8、查询doubao提示不用理会preinstall包，直接ctrl+C即可，但执行openclaw -v和openclaw status后，结果如故。查询doubao提示可以手工安装对应的module

# 进入 openclaw 安装目录 
cd /usr/lib/node_modules/openclaw 
# 直接安装缺失的依赖包（核心修复） 
npm install @buape/carbon

(base) root@aitrainer:/usr/lib/node_modules/openclaw# npm install @buape/carbon
added 267 packages, changed 2 packages, and audited 750 packages in 4m
140 packages are looking for funding
  run `npm fund` for details
2 high severity vulnerabilities
To address all issues, run:
  npm audit fix
Run `npm audit` for details.

9、在安装完上述报丢失的模块后，再次openclaw status，又出现新的报丢失：

(base) root@aitrainer:/usr/lib/node_modules/openclaw# npm install @larksuiteoapi/node-sdk
added 6 packages, and audited 756 packages in 9s
140 packages are looking for funding
  run `npm fund` for details
2 high severity vulnerabilities
To address all issues (including breaking changes), run:
  npm audit fix --force
Run `npm audit` for details.

(base) root@aitrainer:/usr/lib/node_modules/openclaw# npm install @slack/web-api
added 8 packages, and audited 764 packages in 8s
141 packages are looking for funding
  run `npm fund` for details
2 high severity vulnerabilities
To address all issues (including breaking changes), run:
  npm audit fix --force
Run `npm audit` for details.

10、安装完毕上述modules后，openclaw status正常。

其它注意事项：

• 期间doubao告知我node.js的版本太新了，要降级到18，但之前openclaw明确要求版本大于22；
• 出现过doubao认为是网络卡住了，要求改为国内源，但改后导致提示出错。
• 操作前做一下备份，虽然不会覆盖.openclaw目录：

- cp -r ~/.openclaw ~/.openclaw.backup

总结：

openclaw update失败不知道什么原因，多次清除+重装和最后一次结果是一样的，安装对应的缺失的node.js模块即可。加上等待时间，整个过程历时两小时。