win11家庭版 安装 openclaw

Win10 家庭版完全可以装 OpenClaw，和专业版流程几乎一样，只是没有组策略、不能用 WSL2 高级功能，用原生 Windows 一键安装最稳。

一、先做 3 件事（家庭版必看）

1. 系统检查
   • Win+R → 输入 winver → 确认是 64位 Win10 1903+（家庭版没问题）
   • 内存 ≥4GB、磁盘 ≥500MB、联网
2. 关闭干扰
   • 临时关闭 360/电脑管家/Windows Defender 实时防护（装完再开）
   • 关闭 VPN/代理，避免下载失败
3. 安装 Node.js（必须）

   • 官网下载 Node.js 24.x LTS 64位 .msi：https://nodejs.org/

   • 安装时必须勾选 Add to PATH，一路默认

   • 验证（管理员 PowerShell）：

     node -v
     npm -v

     出现版本号就对了

二、Win10 家庭版安装步骤（最稳）

1. 以管理员打开 PowerShell

• Win+X → 选 Windows PowerShell (管理员)
• 标题栏显示"管理员"才对

2. 放开脚本权限（必做）

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

• 提示时输入 Y 回车

3.安装

参考-入门指南

https://openclaw.cc/start/getting-started.html

npm install -g openclaw@latest
或者
pnpm add -g openclaw@latest

4. 验证与启动

# 验证版本
openclaw --version
# 初始化并开机自启
openclaw onboard --install-daemon
# 启动网关（默认端口 18789）
openclaw gateway --port 18789

• 浏览器访问：http://localhost:18789 即可用

三、家庭版常见问题（必看）

• 报错"权限不足"：全程用管理员 PowerShell，UAC 弹窗点"是"
• 下载慢/失败：用上面的 Gitee 国内镜像，别用官方原版
• 端口占用 ：换端口启动：openclaw gateway --port 18790
• 家庭版没有 WSL2：不用装 WSL2，原生 Windows 完全够用

需要我给你一份家庭版专属的 OpenClaw 常用命令速查表 （启动/停止/日志/更新/卸载）吗？

下面给你一套Windows家庭版 + NPM安装OpenClaw 的完整流程，把Cmake、VC环境、Node、Python全部一次性搞定，按顺序做基本不会报错。

一、先确认系统与版本要求

• Windows 10/11 64位（家庭版完全支持）
• Node.js ≥ 22.16.0（必须，低版本必报错）
• Python 3.10--3.12（不要3.13+）
• Cmake + VC++ 2022 构建工具（解决你现在的两个报错）

---

二、安装核心依赖（按顺序）

1. 安装 Node.js（必装）

• 下载：https://nodejs.org/zh-cn/download/ → 选 22.x LTS（msi安装包）

• 安装时必须勾选 ：

  • ✅ Add to PATH（自动加环境变量）
  • ✅ Automatically install the necessary tools...（自动装Python、Chocolatey、构建工具）

• 安装完成后重启电脑

• 验证（管理员终端）：

  node -v  # 应 ≥22.16.0
  npm -v

2. 安装 VC++ 2022 构建工具（解决VC环境报错）

• 下载：https://aka.ms/vs/17/release/vs_BuildTools.exe
• 安装时只勾选 （别装完整VS，太大）：
  • ✅ Desktop development with C++（主工作负载）
  • ✅ MSVC v143 - VS 2022 C++ x64/x86 生成工具
  • ✅ Windows 11 SDK（最新版）
  • ✅ C++ CMake tools for Windows（自带Cmake，解决Cmake报错）
• 安装完成重启电脑

3. 验证 Cmake 已装好

管理员终端输入：

cmake --version

出现版本号即成功。

4. 验证 Python（自动装好了）

python --version  # 应 3.10--3.12

如果没装：去 https://www.python.org/downloads/ 装 3.11，勾选 Add Python to PATH

---

三、NPM 安装 OpenClaw（国内加速）

1. 先切国内镜像（防超时）

npm config set registry https://registry.npmmirror.com

2. 全局安装（管理员终端）

npm install -g openclaw@latest

• 若仍报 sharp 相关错误，用这个命令跳过编译：

  SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

3. 验证安装

openclaw --version

输出版本号即成功。

---

四、初始化 OpenClaw

openclaw onboard

按提示完成配置即可。

---

五、常见报错快速修复

1. 权限不足 ：全程用管理员身份打开 PowerShell/CMD
2. node-gyp 编译失败：确认 VC++ 工具已装、已重启、Node ≥22.16
3. Cmake not found ：重装 VC++ 构建工具，确保勾选 C++ CMake tools
4. Python 版本不对：卸载3.13+，装3.11并加PATH

---

六、完整依赖清单（你已全部装完）

• Node.js 22.16+
• npm
• Python 3.10--3.12
• VC++ 2022 构建工具（含MSVC v143、Windows SDK、Cmake）
• Git（可选，源码用）