Windows 10/11 部署 OpenClaw 完全指南
前言：为什么选择 Windows 部署？
OpenClaw 是一个强大的开源机器人控制框架，支持语音交互、视觉感知与大模型决策。虽然 macOS 是开发者的首选，但 Windows 10/11 (x64) 凭借广泛的硬件兼容性和强大的 GPU 生态，同样是部署 OpenClaw 的优秀平台。
核心挑战：
Windows 环境下最大的痛点在于 C++ 编译环境。OpenClaw 依赖的高性能图像处理库 sharp 需要本地编译原生模块，若环境配置不当，极易导致安装失败。
本文将带您一步步跨越这些障碍，完成从零基础到成功控制机器人的全过程。
第一阶段：基础环境搭建 (关键)
在开始之前，请确保您的系统为 Windows 10/11 x64 版本，并准备好 管理员权限。
1. 安装 Node.js (v22 LTS)
OpenClaw 基于最新的 Node.js 构建，长期支持版 (LTS) 能提供最佳的稳定性。
- 下载：访问 Node.js 官网，下载 LTS 版本 (确保版本号 ≥ v22.x.x，如 v22.22.1)。
- 安装注意：
- ✅ 勾选 "Automatically install the necessary tools" (如果安装程序提供此选项，可自动安装部分编译工具)。
- ✅ 务必勾选 "Add to PATH"，以便在任意终端调用。
验证： 打开 PowerShell 或 CMD (建议右键以管理员身份运行)：
node -v
npm -v
2. 安装 Windows Build Tools (成败关键) ⚠️
这是 Windows 安装过程中最容易报错的环节。sharp 库需要完整的 C++ 编译链。
方法一：通过 npm 自动安装 (推荐)
在 管理员 PowerShell 中运行：
npm install --global windows-build-tools
- 说明：该命令会静默下载并安装 Visual Studio Build Tools 和 Python 环境。
- 注意：过程可能持续 5-10 分钟，期间看似无反应，请耐心等待直到出现
success提示。
方法二：手动安装 (若方法一卡住)
如果自动安装失败，请手动操作：
- 下载 Visual Studio Build Tools 2022。
- 运行安装程序，在工作负载中选择 '使用 C++ 的桌面开发' (Desktop development with C++)。
- 在右侧详细信息中，确保勾选：
- MSVC v143 - VS 2022 C++ x64/x86 build tools
- Windows 10/11 SDK
- 安装完成后，重启终端甚至重启电脑以确保环境变量生效。
3. 安装 Git for Windows
用于克隆代码仓库。
- 访问 Git SCM 下载并安装。
- 保持默认选项即可。
- 验证：
git --version
第二阶段：安装 OpenClaw
我们提供两种安装方式。方式 B (手动安装) 最为稳妥，推荐所有用户优先尝试。
方式 A：一键安装脚本 (快捷尝试)
OpenClaw 提供了适配 Windows 的安装脚本。
- 打开 PowerShell (管理员)。
- 如果遇到执行策略报错（常见于首次运行脚本，node：npm error code 128），在 PowerShell 输入：
运行以下命令（包含 TLS 协议强制开启，防止下载失败）：
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://openclaw.ai/install.ps1'))
💡 提示：如果脚本执行后窗口闪退或报错，请直接使用下方的方式 B。
方式 B：手动安装 (最稳妥，强烈推荐) 🌟
手动安装能让您清晰看到每一步的执行情况，便于排查问题。
# 1. 创建安装目录
mkdir C:\openclaw
cd C:\openclaw
# 2. 克隆代码库 (注意末尾的点 ".")
git clone https://github.com/openclaw/openclaw.git .
# 3. 配置国内镜像 (大幅提升下载速度)
npm config set registry https://registry.npmmirror.com
# 4. 安装依赖
npm install
- 🔴 常见报错处理：
如果在此步出现
gyp ERR!或sharp相关错误，说明 Build Tools 未正确安装或未生效。请返回第一阶段重新检查，并确保重启了终端。
# 5. (可选) 全局链接命令，方便直接调用
npm link
第三阶段：启动与核心配置
1. 启动服务
在终端中执行：
openclaw start
# 如果未执行 npm link，请使用：
npx openclaw start
⚠️ 防火墙警告： 首次启动时，Windows 防火墙会弹出警告。务必点击'允许访问'，并建议同时勾选 '专用网络' 和 '公用网络'。否则，OpenClaw 将无法与局域网内的机器人通信。
2. 验证启动
- 打开浏览器，访问：
http://localhost:18789 - 在聊天框输入：'你好'。
- 成功标志：2-3 秒内收到回复。
3. 核心模型配置 (LLM Provider)
🚨 重要原则：请优先使用云端 API。
除非您拥有 RTX 4090 等高端显卡，否则严禁在本地运行 7B 以上参数的大模型（如 Llama 3, Qwen-7B），这将导致系统严重卡顿甚至死机。
| 配置项 | 推荐设置 | 说明 |
|---|---|---|
| Provider | DeepSeek 或 Aliyun | 性价比高，国内访问速度快。也可选 OpenAI/Azure。 |
| Model Name | deepseek-chat (V3), qwen-max, gpt-4o-mini | ✅ 首选：速度快、逻辑强。 ❌ 避免：任何带 local, ollama 字样的模型。 |
| API Key | DeepSeek / 阿里云 | 填入对应平台的密钥。 |
| Base URL | https://api.deepseek.com/v1, https://dashscope.aliyuncs.com/compatible-mode/v1 | 根据提供商填写对应的接口地址。 |
| Temperature | 0.7 (对话), 0.2 (控制) | 对话需创造性，控制指令需精准。 |
4. 网络与连接配置 (Network & Connectivity)
为了让 OpenClaw 稳定连接局域网内的机器人（如 Jetson Nano），Windows 用户必须注意以下设置：
| 配置项 | 推荐设置 | 原因说明 |
|---|---|---|
| 机器人 IP | 手动输入静态 IP (例：192.168.1.105) | 🔴 强烈建议：Windows 防火墙常拦截 UDP 广播包，导致自动发现失败。请在机器人端查询 IP 后手动填写。 |
| Listen Address | 127.0.0.1 (仅本机), 0.0.0.0 (局域网访问) | 若需从其他电脑访问 OpenClaw 界面，选 0.0.0.0。 |
| Port | 18789 | 默认端口，无需修改。 |
| Discovery | Static IP 模式 | 关闭 UDP Broadcast，改用静态 IP 直连，稳定性提升 100%。 |
结语
至此，您已经在 Windows 上成功部署了 OpenClaw，并完成了针对云端大模型和局域网连接的优化配置。
下一步建议：
- 测试语音交互：点击麦克风图标，尝试语音控制机器人移动。
- 编写自定义技能：利用 OpenClaw 的插件系统，为您的机器人添加专属功能。
- 加入社区：遇到问题时，欢迎前往 GitHub Issues 或官方社区交流。
祝您在机器人开发的道路上探索愉快！🤖🚀
