> ## Content Index
> Fetch the complete content index at: https://tbbbk.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# OpenClaw 升级 2026.10.6 提示 Node 版本过低？Windows / Mac / Linux 升级 Node 24.22.1 教程
- URL: https://tbbbk.com/openclaw-2026-10-6-node-upgrade/
- Published: 2026-11-04T15:03:23.000Z
- Updated: 2026-11-04T15:03:23.000Z
- Description: OpenClaw 2026.10.6 起要求 Node 24.22.1 以上：为什么、怎么查、各系统怎么升级，以及升级后要注意的地方。
- Author: TuBaiBai
- Tags: OpenClaw, 教程

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`，详见[启动 / 重启 / 停止命令大全](https://tbbbk.com/openclaw-start-restart-stop-commands-guide-2026/)）
- **升级卡住、提示确认不了正在运行的 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 中文教程合集](https://tbbbk.com/openclaw-guide/)，各版本更新内容见 [OpenClaw 2026 更新汇总](https://tbbbk.com/openclaw-updates-2026/)。

参考：[OpenClaw 2026.10.6 发布说明](https://github.com/openclaw/openclaw/releases/tag/v2026.10.6)、[官方文档](https://docs.openclaw.ai/releases/2026.10.6)、[Node.js 2026 年 10 月安全更新](https://nodejs.org/en/blog/vulnerability/october-2026-security-releases)。