4. 环境准备：Node 版本要求与系统检查

本节目标：确认你的电脑满足 OpenClaw 的 Node 版本要求，学会自查版本，知道不够时怎么办。读完你能判断自己要不要先升级 Node。

为什么先查 Node

OpenClaw 跑在 Node 上。版本不对，装了也起不来，报错还不好懂。

所以动手安装前，先确认本机 Node 够新。这一步两分钟，能省后面一堆麻烦。

Note

本教程基于 npm 上 2026.7.1-2 版本撰写。它的 Node 要求比早年的教程更严，别拿旧文章的”Node 18 就行”当标准。

OpenClaw 接受下面任意一档：

注意：Node 23 不在支持范围。装了 23 反而要降级或升到 25。

Tip

优先用 Node 24。它既是官方推荐，也是发布流程的默认运行时，踩坑概率最低。

打开终端，跑一条命令：

node -v

输出类似 v24.15.0 这样。看主版本号：

如果终端报 command not found，说明根本没装 Node，直接走下面的升级。

思路只有一条：把 Node 升到支持的版本。别去改 OpenClaw，它不背这个兼容包袱。

官方推荐用版本管理器，切换干净、不影响系统其他项目：

# fnm 示例
fnm install 24
fnm use 24

macOS 也可用 Homebrew：

brew install node

Windows 可用 winget：

winget install OpenJS.NodeJS.LTS

Note

只从 Node 官网（nodejs.org）或系统包管理器获取安装包。本教程不贴第三方下载镜像，避免来源不可靠或夹带旧版本。

很多”升级了还是老版本”的坑，源于终端没刷新环境变量。

装完在新终端再跑一次：

node -v

确认数字变了再继续。若仍显示旧的，把版本管理器的初始化写进 shell 启动文件（~/.zshrc 或 ~/.bashrc），新开终端即可。

少数情况 npm 全局命令找不到。本质是全局 bin 目录没进 PATH：

npm prefix -g
echo "$PATH"

看输出里有没有那个 bin 路径。没有就把它加进启动文件，具体写法各系统略有差异，可查 npm 官方排错文档。

Tip

环境变量类问题，重启一个终端往往比改配置更快见效。先关掉重开，再下结论。

全打勾，环境就过关了。下一章正式安装 OpenClaw。