OpenClaw 依赖 Git、Node.js（v22.3.0 LTS）和 pnpm，三者缺一不可：Node.js 提供运行环境并需正确配置 PATH；Git 用于技能模块的克隆与管理；pnpm 替代 npm 加速安装并节省空间；全部依赖须通过 node -v、npm -v、git --version、pnpm -v 验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw 依赖 Git 和 Node.js 作为底层运行支撑，缺一不可。Git 负责代码拉取、技能更新与版本同步；Node.js 则是整个智能体的执行引擎——所有模块（Gateway、Agent、Skills）都基于 Node 运行。二者若未正确安装或环境变量缺失，会导致 openclaw install 报错、服务启动失败、甚至 UI 无法加载。
Node.js：必须装对版本，且 PATH 要生效
OpenClaw 官方明确推荐 Node.js v22.3.0 LTS 版本，高版本（如 v24+）存在兼容性问题，低版本（v18 以下）则缺少关键 API 支持。
- 下载地址固定为：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 自带，但 OpenClaw 项目依赖多、体积大，使用 npm 安装常出现超时、重复下载、磁盘占用高等问题。pnpm 采用硬链接复用机制，安装速度提升约 3 倍，且节省 60% 以上磁盘空间。
- 安装命令（管理员或普通权限均可）：
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 安装时未加-g参数，或安装路径被安全软件拦截，重装即可
