OpenClaw 安装失败，最常见的不是项目本身坏了，而是环境没对上。OpenClaw 的官方开源仓库是 https://github.com/openclaw/openclaw，安装文档则在 https://docs.openclaw.ai/install/index。官方安装页写得很直接：Node 24 是推荐版本，Node 22.14+ 也能用；Windows 可以原生装，但官方更推荐 WSL2。
先看最容易踩的三个点
第一是 Node 版本太老，安装脚本会直接卡住；第二是 Windows 环境没走 WSL2，后面 npm、权限、路径都容易出小问题；第三是装完以后 openclaw 命令找不到，多半是 PATH 没配好，不是程序没装上。
更稳的做法
如果你是第一次装，优先用官方安装脚本，不要一上来就自己拼命令。脚本会自动检测系统、安装 Node、拉起 onboarding，能少踩很多边角坑。要是你已经在源码目录里，官方也支持 git/install-cli 这种路径，但前提仍然是 Node 和 Git 这些基础条件先正常。
如果还是报错，按这个顺序查
- 先跑 `node -v`，确认版本够不够。
- Windows 用户优先切到 WSL2，再重新装一次。
- 执行 `npm prefix -g`，检查全局 bin 目录有没有进 PATH。
很多人把安装失败理解成“OpenClaw 不兼容我的电脑”，其实往往只是安装链路里某一环没准备好。把 Node、Git、WSL2 和 PATH 这些基础项补齐，安装成功率会高很多。
