部署OpenClaw前须完成五项检查：一、确认为64位Windows 10（2004+）或Win11（22H2+），禁用LTSC/Server；二、安装Git并加入PATH，PowerShell≥5.1且支持TLS 1.2；三、确保%USERPROFILE%所在磁盘≥20GB，关闭受控文件夹访问，手动创建并授权%LOCALAPPDATA%\Temp\openclaw；四、使用nvm-windows安装并切换至Node.js v22+；五、临时禁用安全软件，关闭实时防护，设置PowerShell执行策略为RemoteSigned。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您计划在Windows系统上本地部署OpenClaw，但安装过程中频繁失败或服务无法启动，则很可能是由于基础环境未满足最低运行要求。以下是开展部署前必须完成的检查与准备步骤：
一、验证操作系统版本与架构
OpenClaw仅支持64位Windows 10（版本2004及以上）或Windows 11（推荐22H2及以上）。32位系统、Windows Server或LTSC长期服务版均不被官方支持，强行部署会导致Node.js依赖加载失败或二进制模块崩溃。
1、按下 Win + R，输入 winver 并回车，确认弹出窗口中显示“64位操作系统”且版本号不低于“2004”。
2、若版本过低，需前往“设置 → 更新与安全 → Windows更新”手动检查并安装功能更新。
3、若当前为Windows LTSC或Server版本，必须更换为标准版Windows 10/11，否则后续所有步骤均无效。
二、确认必备工具已正确安装
Git与PowerShell是脚本执行与依赖拉取的基础组件。Git缺失将导致npm install阶段报错“git not found”，PowerShell版本过低则无法解析TLS 1.2协议，使安装脚本下载中断。
1、以普通用户身份打开CMD，执行 git --version；若提示“不是内部或外部命令”，需立即安装Git for Windows，并在安装时勾选 “Add Git to the system PATH” 选项。
2、在PowerShell中执行 $PSVersionTable.PSVersion，确认Major值 ≥ 5；若为5.0或更低，需升级至PowerShell 5.1或更高版本。
3、执行 iwr https://openclaw.ai -UseBasicParsing 测试网络连通性与TLS兼容性；若返回错误，需提前运行安全协议修复命令。
三、检查磁盘空间与路径权限
OpenClaw默认将配置文件存于 %USERPROFILE%\.openclaw，模型缓存与日志写入 %LOCALAPPDATA%\Temp\openclaw。若用户目录位于网络驱动器、OneDrive同步目录或启用了受控文件夹访问（Windows Defender），会导致写入拒绝或配置丢失。
1、打开文件资源管理器，在地址栏输入 %USERPROFILE% 回车，确认该路径所在磁盘剩余空间 ≥ 20GB。
OpenClaw 基础设施心跳监控与自动恢复：部署/卸载心跳守护进程，配置主机监控（Gateway、磁盘、内存、CPU、进程），设置飞书告警，自动重启故障Gateway。适用关键词：心跳监控、heartbeat daemon、服务器告警、自动重启、健康检查、auto recovery。
2、右键点击“此电脑 → 属性 → 系统保护 → 系统保护选项卡”，检查C盘“受保护的系统卷”状态是否启用；若启用，需临时关闭“受控文件夹访问”功能。
3、在PowerShell中执行 Test-Path "$env:LOCALAPPDATA\Temp\openclaw" -PathType Container，若返回False，手动创建该目录并赋予当前用户完全控制权限。
四、排查Node.js版本冲突
OpenClaw明确要求Node.js v22或更新版本。使用v18/v20可能导致WebSocket握手失败、加密模块不可用或ESM导入异常。若系统已安装旧版Node.js，nvm-windows可实现多版本隔离，避免全局污染。
1、在PowerShell中执行 node -v，确认输出为 v22.x.x 或更高；若低于v22，不得直接覆盖安装。
2、从GitHub Releases下载并安装 nvm-windows，安装完成后重启终端。
3、依次执行：nvm list available 查看可用版本，nvm install 22.14.0 安装指定LTS版本，nvm use 22.14.0 切换为当前默认版本。
五、禁用可能干扰的第三方软件
部分安全软件（如火绒、360、卡巴斯基）会主动拦截PowerShell脚本执行、阻断localhost端口绑定或删除临时下载的.ps1文件，造成安装脚本静默退出或gateway服务启动后立即终止。
1、临时退出所有国产安全软件主程序，包括后台守护进程与自启动项。
2、进入Windows安全中心 → “病毒和威胁防护” → “管理设置”，关闭“实时保护”与“基于云的保护”。
3、在PowerShell中执行 Get-ExecutionPolicy -List，确认CurrentUser策略为 RemoteSigned 或 Unrestricted；若为Undefined或AllSigned，需执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。
