阅读时间 4 分钟

OpenClaw 升级 2026.10.6 提示 Node 版本过低?Windows / Mac / Linux 升级 Node 24.22.1 教程

OpenClaw 2026.10.6 起要求 Node 24.22.1 以上:为什么、怎么查、各系统怎么升级,以及升级后要注意的地方。

OpenClaw 10 月 22 日发了 2026.10.6,这版有个硬性要求:Node.js 必须是 24.22.1 以上,或者 26.12.1 以上。Node 版本不够的话,openclaw update 会直接拒绝安装,并给出恢复提示,好处是不会把你正在跑的 OpenClaw 搞坏。

所以想升级 OpenClaw,得先把 Node 升上去。这篇讲清楚为什么要升、怎么查、Windows / Mac / Linux 分别怎么升,以及升完要注意的几个地方。

为什么非要升 Node

Node.js 10 月 21 日发布了安全更新,其中一项是:印度 CA 机构 eMudhra 的中间证书私钥泄露了,新版 Node 已经不再信任用这些私钥签发的证书。旧版本 Node 还信任这些证书,存在被中间人攻击的风险。OpenClaw 要联网调用各种模型和服务,所以直接把最低版本卡在了修复后的版本上。

这次 Node 安全更新还修了 Brotli 解压可能导致远程代码执行、TLS 主机名校验绕过等好几个高危漏洞。就算不升 OpenClaw,Node 也建议升一下。

各版本线修复后的版本:

  • Node 26:26.12.1
  • Node 24:24.22.1
  • Node 22:22.23.4(不过 OpenClaw 2026.10.6 只认 24 和 26,22 的用户要直接升到 24)

先查一下自己的版本

node -v

显示 v24.22.1 及以上、或者 v26.12.1 及以上,就不用动了,直接 openclaw update。低于这个版本,按下面对应的系统升级。

用 Docker 版 OpenClaw 的不用管:官方镜像已经自带 Node 24.22.1,拉新镜像就行。用官方安装脚本新装的,也会自动选修复后的版本。只有自己装 Node 的才需要手动升。OpenClaw 不会帮你升级 Node。

Windows 升级 Node

用 nvm-windows 的(推荐,方便以后切换版本):

nvm install 24.22.1
nvm use 24.22.1
node -v

没用 nvm 的:去 Node.js 官网下载 24.22.1 的 Windows 安装包,直接覆盖安装。装完关掉所有终端窗口重新打开,再 node -v 确认,不然当前窗口还是旧版本。

Mac 升级 Node

用 nvm 的:

nvm install 24.22.1
nvm alias default 24.22.1
node -v

用 Homebrew 装的 Node,先 brew update,再升级你装的那个版本(比如 brew upgrade node@24),最后用 node -v 确认已经到 24.22.1 以上。Homebrew 的更新偶尔会晚几天,版本号不够就先用 nvm。

Linux / VPS 升级 Node

VPS 上用 nvm 最省事:

nvm install 24.22.1
nvm alias default 24.22.1
node -v

还没装 nvm 的,按 nvm 官方 GitHub 上的安装命令装一下,装完重新登录 SSH 再执行上面三行。

升完 Node,再升 OpenClaw

openclaw update
openclaw gateway restart
openclaw status

有两个容易踩的坑:

  • 后台服务可能还在用旧 Node。尤其是用 nvm 的,后台常驻服务可能记着旧版本 Node 的路径。升完先用 openclaw gateway status 看一下是否正常;不对的话,重新安装一次后台服务(openclaw onboard --install-daemon,详见启动 / 重启 / 停止命令大全)
  • 升级卡住、提示确认不了正在运行的 Gateway。这版加了保护:升级时如果确认不了哪个 Gateway 在跑,会直接停下。先用 openclaw gateway stop 停掉(Windows 也可以在任务计划程序里停),再重新 openclaw update

2026.10.6 升级后还要注意的

这版官方说是"只有可靠性修复",但有几处会影响老用户:

  • 命令补全:重新生成一次,openclaw completion --write-state
  • 还在用 CLAWDBOT_GATEWAY_PASSWORD 环境变量的(从 Clawdbot 时代一路升级过来的老用户),改成 OPENCLAW_GATEWAY_PASSWORD
  • 定时任务指定了工具的:openclaw cron edit <id> --tools exec 会覆盖整个工具列表,要把这个任务需要的工具全部写上
  • Windows 用源码安装的:官方说可能需要手动从源码更新一次,之后才能正常自动更新
  • Hook 少了密钥:现在 Gateway 不会因此挂掉,而是自动禁用对应的 Hook。把密钥加回服务环境变量,再重启就行

官方发布说明里没有给出"Node 版本过低"时的具体报错原文,所以我没法贴原文。只要看到 update 拒绝安装、提示和 Node 版本有关,按上面的步骤先升 Node 就对了。

OpenClaw 其他问题(命令、切模型、重装、报错)都整理在 OpenClaw 中文教程合集,各版本更新内容见 OpenClaw 2026 更新汇总。

参考:OpenClaw 2026.10.6 发布说明、官方文档、Node.js 2026 年 10 月安全更新。