OpenClaw Windows版v2.7.9安装报错本质是依赖缺失或配置冲突，需先验证Node.js（≥v23.0.0）和Git（≥v2.40.0）是否就位，再通过修复脚本或手动安装补全，继而切换Git HTTPS协议、重置网关环境并重启系统。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw Windows版v2.7.9安装时频繁弹出“command not found”“Error code 128”“网关断开”等报错，本质是系统缺少底层运行环境或依赖配置冲突，不是程序本身损坏，只需针对性修复对应组件即可恢复部署流程。
先确认是否真缺依赖
打开命令提示符（Win+R → 输入cmd → 回车），依次执行以下两条命令：
node -v → 若返回“不是内部或外部命令”，说明Node.js未就位；
git --version → 若提示“未找到命令”，说明Git缺失或未加入系统PATH。
【必须满足：Node.js ≥ v23.0.0、Git ≥ v2.40.0】，低于这两个版本将直接触发后续全部报错，无需往下排查其他环节。
一键补全核心依赖（Windows专属）
方法一：使用内置修复脚本（推荐）
进入OpenClaw解压后的根目录，双击运行repair-deps-win.bat（红色龙虾图标旁的批处理文件）；
脚本会自动检测缺失项，下载并静默安装适配v2.7.9的Node.js 23.5.0与Git 2.45.1；
安装完成后自动重启终端服务，无需手动干预路径配置。
方法二：手动安装（仅当脚本运行失败时启用）
前往官网下载独立安装包：
Node.js 23.5.0 LTS（Windows x64）→ https://nodejs.org/dist/v23.5.0/node-v23.5.0-x64.msi
Git 2.45.1 for Windows → https://github.com/git-for-windows/git/releases/download/v2.45.1.windows.1/Git-2.45.1-64-bit.exe；
安装Node.js时务必勾选「Add to PATH」；
安装Git时在第三步选择「Use Git from Windows Command Prompt」，否则cmd中仍无法识别git命令。
修复Git协议导致的拉取失败
第一步：以管理员身份打开PowerShell（右键开始菜单 → Windows PowerShell（管理员））；
第二步：执行强制HTTPS协议切换命令：
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
git config --global url."https://github.com/".insteadOf git@github.com:
第三步：清空本地Git缓存并验证配置：
git config --global --get-regexp url
若输出包含两行https映射，则修复完成；若无输出，说明上一步未生效，需重新执行并检查是否以管理员权限运行。
重置网关环境（解决1008/4008错误）
① 打开OpenClaw安装目录下的tools子文件夹；
② 双击运行reset-gateway-env.bat；
③ 脚本将自动执行三项操作：生成新gateway token、释放18789端口占用、重建网关配置文件；
④ 完成后关闭所有OpenClaw相关进程（任务管理器中结束openclaw-gateway.exe、openclaw-agent.exe）；
【关键动作】重启电脑再启动OpenClaw，否则端口释放可能不彻底。
