Windows 10/11 部署 OpenClaw:环境搭建与机器人互联
前言:为什么选择 Windows 部署?
OpenClaw 是一个强大的开源机器人控制框架,支持语音交互、视觉感知与大模型决策。虽然 macOS 是开发者的首选,但 Windows 10/11 (x64) 凭借广泛的硬件兼容性和强大的 GPU 生态,同样是部署 OpenClaw 的优秀平台。
介绍在 Windows 10/11 x64 环境下部署 OpenClaw 开源机器人控制框架的完整流程。涵盖 Node.js 安装、Windows Build Tools 配置(解决 sharp 库编译问题)、代码克隆及依赖安装。重点解析了云端大模型(如 DeepSeek、阿里云)的配置策略,避免本地运行大模型导致的性能瓶颈,并提供了局域网内机器人连接的静态 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 # 应显示 v22.x.x
npm -v
这是 Windows 安装过程中最容易报错的环节。sharp 库需要完整的 C++ 编译链。
在 管理员 PowerShell 中运行:
npm install --global windows-build-tools
success 提示。如果自动安装失败,请手动操作:
用于克隆代码仓库。
git --version我们提供两种安装方式。方式 B (手动安装) 最为稳妥,推荐所有用户优先尝试。
OpenClaw 提供了适配 Windows 的安装脚本。
运行以下命令(包含 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。
手动安装能让您清晰看到每一步的执行情况,便于排查问题。
# 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