想要顺利运行 OpenClaw，首先需要安装三个关键组件：Git、Node.js（v22.3.0 LTS）以及 pnpm。这三者缺一不可——Node.js 是整个运行环境的核心底座，必须正确配置系统 PATH；Git 负责技能模块的克隆与版本管理；pnpm 则用于替代 npm，安装速度更快、占用磁盘空间更少。完成安装后，务必依次执行 node -v、npm -v、git --version、pnpm -v 这几条命令进行验证，全部显示版本号才算配置成功。
Git 和 Node.js 是 OpenClaw 的基石，缺少任何一个都无法正常搭建。Git 负责代码拉取、技能更新以及版本同步；Node.js 则是智能体的执行引擎——Gateway、Agent、Skills 等模块都依赖于它。如果安装不正确或环境变量配置不到位，后续执行 openclaw install 时必定报错，服务无法启动，甚至 UI 界面也会卡死。
Node.js：必须安装对应版本，且 PATH 要生效
OpenClaw 官方明确推荐的 Node.js 版本是 v22.3.0 LTS。如果使用 v24 及以上的高版本，可能会出现兼容性问题；而 v18 以下的低版本又缺少关键 API，所以 v22.3.0 是最稳妥的选择。
- 下载地址固定为：https://www.php.cn/link/e327949a17d035ca60d110b4ce6b7274
- 安装时务必勾选「Add to PATH」——这是 Windows 系统下最关键的步骤，否则在 PowerShell 中输入
node -v会提示“命令未识别” - 建议自定义安装路径，例如
D:\Node.js，避免使用中文或空格，也不要放在 C 盘，以防止后续出现权限和路径解析问题 - 如何验证？打开 PowerShell（使用普通用户身份即可），分别运行
node -v和npm -v，应分别返回v22.3.0和10.8.1类似的版本号
Git：不是可选项，而是 OpenClaw 技能管理的基础设施
OpenClaw 的技能模块（Skills）默认通过 Git 克隆远程仓库来加载，例如自动部署邮件处理、文档解析等功能。如果没有安装 Git，或者 Git 未加入系统 PATH，那么 openclaw skill add 这个命令将直接失效。
- Windows 用户可以直接下载最新安装包：https://www.php.cn/link/7ca2d2c04c0bb98f7b3481751387214a
- 安装到「Adjusting your PATH environment」步骤时，选择「Git from the command line and also from 3rd-party software」——这样 Git 才能在 PowerShell 和 CMD 中全局生效
- 安装完成后无需额外配置，打开任意终端，输入
git --version，如果返回类似git version 2.45.1.windows.1的信息，说明安装成功 - 如果安装后命令无法使用，说明 PATH 环境变量未生效。可以尝试重启 PowerShell，或者手动将 Git 安装目录下的
bin文件夹（例如C:\Program Files\Git\bin）添加到系统环境变量中
pnpm：提速 + 省空间，OpenClaw 最新推荐的包管理器
虽然 npm 会随 Node.js 一同安装，但 OpenClaw 项目依赖众多、体积庞大，使用 npm 安装时经常出现超时、重复下载、磁盘占用过高等问题。pnpm 采用硬链接复用机制，安装速度可提升约 3 倍，磁盘空间节省六成以上。
- 安装命令（管理员或普通权限均可）：
npm install -g pnpm - 安装后立即配置国内镜像源：
pnpm config set registry https://registry.npmmirror.com - 验证方法：
pnpm -v返回版本号（例如9.12.3），再执行pnpm config get registry能看到镜像地址即可确认 - 后续所有 OpenClaw 操作，例如源码构建、插件安装，都统一使用
pnpm代替npm，更稳定可靠
验证与补救：三步确认依赖就绪
安装完成后先不要急于运行 OpenClaw，进行完整的闭环验证：
- 打开一个新的 PowerShell 窗口（不要使用之前的旧窗口），依次执行
node -v、npm -v、git --version、pnpm -v。四条命令均有版本号输出，才算通过 - 如果某条命令提示「不是内部或外部命令」，说明对应的程序没有添加到 PATH 环境变量中，需要返回检查安装选项，或手动补充环境变量
- 如果 node 可用但 pnpm 无法使用，通常是因为 npm 安装 pnpm 时没有加
-g参数，或者安装路径被安全软件拦截，重新安装一次即可解决