Git与Node.js一键安装指南：Windows环境配置全流程

要在Windows系统上部署OpenClaw，核心是预先配置好Git和Node.js这两个基础运行时环境。缺少任何一项，后续执行npm install -g openclaw@latest命令时，终端都可能报出“command not found”或“git is not recognized”这类错误。确保开发环境配置正确，是避开后续安装障碍的关键。

一键自动化部署Git与Node.js（推荐方案）

追求效率？可通过PowerShell脚本完成自动化部署。首先，在开始菜单中搜索“PowerShell”，右键选择“以管理员身份运行”。获取管理员权限是脚本成功执行的前提。

随后，将下述完整命令复制并粘贴至窗口，按回车执行：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned -Force; iwr -useb https://raw.githubusercontent.com/openclaw/installer/main/win-deps.ps1 | iex

该脚本将自动执行以下操作：识别系统架构（64位或32位），下载最新版的Git和Node.js LTS（长期支持版）并进行静默安装。其核心优势在于，会自动将两者的可执行路径配置到系统环境变量PATH中，并在安装结束后自动调用git --version与node -v进行验证。整个过程无需手动干预，通常在一分半钟内完成。

重要提示：此自动化方案仅支持Windows 10与Windows 11操作系统，且依赖稳定的网络连接。若执行时出现“无法下载”的提示，请检查防火墙设置是否阻止了PowerShell的网络请求。

手动分步配置指南（适用于环境调试或受限网络）

若需精确控制安装过程，或处于特定网络环境，可遵循以下手动步骤完成环境搭建。

第一步：部署Git
访问Git官方网站下载Windows安装程序。运行安装向导时，除了一路点击“Next”采用默认设置外，在最后一步安装界面中，务必勾选“Add Git to the system PATH”选项，再点击Install。此步骤确保系统能在任意命令行位置识别git命令。

第二步：验证Git安装
安装完成后，请关闭所有已开启的命令行窗口，并重新启动一个新的CMD，输入git --version后回车。若终端返回类似git version 2.45.1.windows.1的版本信息，则表明Git已成功部署。

第三步：部署Node.js
前往Node.js官网，点击绿色的“下载LTS版本”按钮获取安装包。运行下载的.msi安装文件，在安装向导中请确保勾选“Add to PATH”选项。遗漏此配置会导致npm包管理器命令无法被系统识别。

第四步：验证Node.js与npm
在同一个新开启的CMD窗口中，依次执行node -v和npm -v命令。两者应分别返回类似v24.11.1和11.6.2的版本号。两项验证均通过，表明基础环境已就绪。

环境配置故障排查

若按上述步骤操作后验证命令仍无效，通常由以下几个常见问题导致。

问题一：环境变量未更新
这是最普遍的原因。系统环境变量PATH的变更不会即时应用于已打开的命令行会话。因此，在安装Git或Node.js后，必须完全关闭并重新启动所有终端窗口（如CMD、PowerShell），再执行验证命令。

问题二：npm全局路径设置冲突
如果之前曾自定义过npm的全局安装路径，可能导致命令注册异常。可在命令行中运行npm config get prefix检查当前配置。默认情况下应返回用户目录路径，例如：C:Users[你的用户名]AppDataRoamingnpm。若路径指向非常规位置（如D盘根目录），可使用npm config delete prefix命令将其重置为默认值，否则OpenClaw的全局安装可能失败。

问题三：安全软件误拦截
部分杀毒软件或系统安全防护工具可能将Node.js安装程序误判为潜在风险。若遇安装过程被阻断，可尝试暂时退出安全软件，待安装完成后再重新启用。安装文件均源自官方网站，通常可确保安全。