Homebrew / winget
像从系统官方常用商店把 Node 装进来。
Install 导读
Node 版本不对、PATH 没配好？先看这里
OpenClaw 强制要求 Node 22.14+，推荐用 Node 24。装完后第一件事：跑 `node -v` 确认版本。如果 `openclaw` 命令找不到，99% 是 npm 全局 bin 没在 PATH 里，按页内三步排查法修复。
先讲这一页到底在解决什么
Node 版本不对、PATH 没配好？先看这里
OpenClaw 强制要求 Node 22.14+，推荐用 Node 24。装完后第一件事：跑 `node -v` 确认版本。如果 `openclaw` 命令找不到，99% 是 npm 全局 bin 没在 PATH 里，按页内三步排查法修复。
第一站
🔢 先看发动机型号对不对
别一上来就怀疑 OpenClaw 本体，先确认 Node 版本。
node -v像先抬头看发动机铭牌。v24.x.x 最舒服，v22.14+ 也还能开。
✅ Node 24
官方现在默认推荐档位，文档、CI、发行流程都围着它转得更顺。
🟡 Node 22
还在支持，但更像“兼容通道”，不是最推荐的新发动机。
🎈 一句话
Node 太旧时，别怪 OpenClaw 走不稳，是发动机先不合格。
第二站
🛠️ 安装方式其实只是“你习惯叫哪家修车师傅”
不同系统只是找不同入口装同一台发动机。
NodeSource
Linux 常见路线，像请 Node 官方合作安装队来铺。
fnm / nvm / mise
像给你一个发动机切换架，方便在不同 Node 版本间换挡。
重点不是哪家
重点是装完以后，新终端也能认得它。
第三站
🛣️ openclaw: command not found，大多数时候不是车没装，而是路牌没挂好
这页后半段几乎都在讲 PATH。
npm prefix -g像问系统：“全局工具架到底放哪儿了？”
echo \"$PATH\"像把地图摊开，看那只工具架是不是已经画在进门路线里。
export PATH=\"$(npm prefix -g)/bin:$PATH\"像把去工具架的路牌正式挂到门口，之后每个新终端都知道往哪找。
📌 版本管理器初始化
如果你用 fnm / nvm 这类切换架，却没在 shell 启动文件里初始化，它就像装了但没接电。
第四站
🔐 Linux 上 EACCES，其实是在说“你在碰一只不归你管的工具柜”
这不是 OpenClaw 特有问题，是 npm 全局安装常见坑。
mkdir -p \"$HOME/.npm-global\"像先给自己单独准备一只可写的私人工具柜。
npm config set prefix \"$HOME/.npm-global\"像告诉 npm：“以后全局工具都放我自己的柜子里。”
export PATH=\"$HOME/.npm-global/bin:$PATH\"然后别忘了再挂路牌，不然新柜子还是找不到。
🎈 收尾一句
Node 这页的核心不是版本名词，而是“发动机对了、路牌也对了”。