OpenClaw 升级 2026.10.6 提示 Node 版本过低?Windows / Mac / Linux 升级 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 更新汇总。