介绍在 Windows 10/11 x64 环境下部署 OpenClaw 开源机器人控制框架的完整流程。主要涵盖 Node.js 及 C++ 编译环境（sharp 库依赖）的配置方法，提供一键脚本与手动安装两种方案。同时解析了云端大模型（如 DeepSeek、阿里云）的 API 配置要点，以及局域网内机器人连接的静态 IP 设置技巧，确保系统稳定运行。
OpenClaw 是一个强大的开源机器人控制框架，支持语音交互、视觉感知与大模型决策。虽然 macOS 是开发者的首选，但 Windows 10/11 (x64) 凭借广泛的硬件兼容性和强大的 GPU 生态，同样是部署 OpenClaw 的优秀平台。
核心挑战：
Windows 环境下最大的痛点在于 C++ 编译环境。OpenClaw 依赖的高性能图像处理库 sharp 需要本地编译原生模块，若环境配置不当，极易导致安装失败。
本文旨在帮助您完成从零基础到成功控制机器人的全过程。
在开始之前，请确保您的系统为 Windows 10/11 x64 版本，并准备好管理员权限。
OpenClaw 基于最新的 Node.js 构建，长期支持版 (LTS) 能提供最佳的稳定性。
验证： 打开 PowerShell 或 CMD (建议右键以管理员身份运行)：
node -v
npm -v
这是 Windows 安装过程中最容易报错的环节。sharp 库需要完整的 C++ 编译链。
在管理员 PowerShell 中运行：
npm install --global windows-build-tools
如果自动安装失败，请手动操作：
用于克隆代码仓库。
git --version我们提供两种安装方式。方式 B (手动安装) 最为稳妥，推荐所有用户优先尝试。
OpenClaw 提供了适配 Windows 的安装脚本。
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。
手动安装能让您清晰看到每一步的执行情况，便于排查问题。
# 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
在终端中执行：
openclaw start
# 如果未执行 npm link，请使用：
npx openclaw start
⚠️ 防火墙警告： 首次启动时，Windows 防火墙会弹出警告。务必点击'允许访问'，并建议同时勾选 '专用网络' 和 '公用网络'。否则，OpenClaw 将无法与局域网内的机器人通信。
http://localhost:18789🚨 重要原则：请优先使用云端 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 (控制) | 对话需创造性，控制指令需精准。 |
为了让 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，并完成了针对云端大模型和局域网连接的优化配置。
下一步建议：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online