跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

Windows 10/11 部署 OpenClaw 指南:环境搭建与机器人互联

Windows 10/11 部署 OpenClaw 需配置 Node.js 及 C++ 编译环境。通过 npm 安装 windows-build-tools 解决 sharp 库依赖问题。支持一键脚本或手动克隆代码库安装。核心配置包括云端大模型 API 接入(推荐 DeepSeek 或阿里云)及局域网静态 IP 连接机器人。防火墙需放行专用网络端口以确保通信稳定。最终实现语音交互与视觉感知功能。

信号故障发布于 2026/4/5更新于 2026/5/2316 浏览

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 提示。
方法二:手动安装 (若方法一卡住)

如果自动安装失败,请手动操作:

  1. 下载 Visual Studio Build Tools 2022。
  2. 运行安装程序,在工作负载中选择 '使用 C++ 的桌面开发' (Desktop development with C++)。
  3. 在右侧详细信息中,确保勾选:
    • 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 的安装脚本。

    1. 打开 PowerShell (管理员)。
    2. 如果遇到执行策略报错(常见于首次运行脚本,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'))
    

    (或者简写版:iwr -useb https://openclaw.ai/install.ps1 | iex)

    💡 提示:如果脚本执行后窗口闪退或报错,请直接使用下方的方式 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. 验证启动
    1. 打开浏览器,访问:http://localhost:18789
    2. 在聊天框输入:'你好'。
    3. 成功标志:2-3 秒内收到回复。
    3. 核心模型配置 (LLM Provider)

    🚨 重要原则:请优先使用云端 API。 除非您拥有 RTX 4090 等高端显卡,否则严禁在本地运行 7B 以上参数的大模型(如 Llama 3, Qwen-7B),这将导致系统严重卡顿甚至死机。

    配置项推荐设置说明
    ProviderDeepSeek 或 Aliyun性价比高,国内访问速度快。也可选 OpenAI/Azure。
    Model Namedeepseek-chat (V3)
    qwen-max
    gpt-4o-mini
    ✅ 首选:速度快、逻辑强。
    ❌ 避免:任何带 local, ollama 字样的模型。
    API KeyDeepSeek
    阿里云
    填入对应平台的密钥。
    Base URLhttps://api.deepseek.com/v1
    https://dashscope.aliyuncs.com/compatible-mode/v1
    根据提供商填写对应的接口地址。
    Temperature0.7 (对话)
    0.2 (控制)
    对话需创造性,控制指令需精准。
    4. 网络与连接配置 (Network & Connectivity)

    为了让 OpenClaw 稳定连接局域网内的机器人(如 Jetson Nano),Windows 用户必须注意以下设置:

    配置项推荐设置原因说明
    机器人 IP手动输入静态 IP
    (例:192.168.1.105)
    🔴 强烈建议:Windows 防火墙常拦截 UDP 广播包,导致自动发现失败。请在机器人端查询 IP 后手动填写。
    Listen Address127.0.0.1 (仅本机)
    0.0.0.0 (局域网访问)
    若需从其他电脑访问 OpenClaw 界面,选 0.0.0.0。
    Port18789默认端口,无需修改。
    DiscoveryStatic IP 模式关闭 UDP Broadcast,改用静态 IP 直连,稳定性提升 100%。

    结语

    至此,您已经在 Windows 上成功部署了 OpenClaw,并完成了针对云端大模型和局域网连接的优化配置。

    下一步建议:

    1. 测试语音交互:点击麦克风图标,尝试语音控制机器人移动。
    2. 编写自定义技能:利用 OpenClaw 的插件系统,为您的机器人添加专属功能。
    3. 加入社区:遇到问题时,欢迎前往 GitHub Issues 或官方社区交流。

    祝您在机器人开发的道路上探索愉快!🤖🚀

    目录

    1. Windows 10/11 部署 OpenClaw 完整流程
    2. 前言:为什么选择 Windows 部署?
    3. 第一阶段:基础环境搭建 (关键)
    4. 1. 安装 Node.js (v22 LTS)
    5. 2. 安装 Windows Build Tools (成败关键) ⚠️
    6. 方法一:通过 npm 自动安装 (推荐)
    7. 方法二:手动安装 (若方法一卡住)
    8. 3. 安装 Git for Windows
    9. 第二阶段:安装 OpenClaw
    10. 方式 A:一键安装脚本 (快捷尝试)
    11. 方式 B:手动安装 (最稳妥,强烈推荐) 🌟
    12. 1. 创建安装目录
    13. 2. 克隆代码库 (注意末尾的点 ".")
    14. 3. 配置国内镜像 (大幅提升下载速度)
    15. 4. 安装依赖
    16. 5. (可选) 全局链接命令,方便直接调用
    17. 第三阶段:启动与核心配置
    18. 1. 启动服务
    19. 如果未执行 npm link,请使用:
    20. 2. 验证启动
    21. 3. 核心模型配置 (LLM Provider)
    22. 4. 网络与连接配置 (Network & Connectivity)
    23. 结语
    • 💰 8折买阿里云服务器限时8折了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

    微信扫一扫,关注极客日志

    微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

    更多推荐文章

    查看全部
    • Python EXE 解包工具实战:py2exe 与 pyinstaller 逆向
    • 论文 AI 生成率阈值解析:检测差异与合规写作建议
    • AI Agent 技术解析:定义、架构与主流框架实践
    • 嵌入式 C/C++ 面试:STL 容器与算法详解
    • sherpa-onnx 离线语音部署框架:支持 Whisper、Moonshine、SenseVoice 等模型
    • 8 款 AI 论文降重工具对比:智能改写与写作功能分析
    • 机器人操作 VLA 模型强化学习综述
    • 华为 OD 算法题解:优雅子数组
    • 基于 Leaflet 和天地图的长沙市免费运动场所 WebGIS 可视化
    • VR/AR/MR 技术详解:虚实交互的区别与核心应用
    • 开源分享:AI Agent Skills 资源合集,一键安装 Cursor/Claude Code/Copilot 技能包
    • 常用 Linux 命令详解及后端开发核心应用场景
    • Trae AI 将设计稿自动生成前端代码实战指南
    • 分布式光纤声波传感(DAS)无人机入侵探测技术与应用
    • 基于 WebUploader 与 PHP 的飞行日志分片上传可靠性方案
    • Python 技术生态全景:Web 开发、数据科学与自动化实战
    • 知识库问答机器人:基于 SpringAI+RAG 的完整实现
    • MySQL 零基础入门到实战:核心知识点梳理与避坑指南
    • 2024 年中国人工智能系列白皮书:体育人工智能
    • Vue3 + Python 体育赛事发布与在线购票选座系统设计

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

    • 随机西班牙地址生成器

      随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

    • Keycode 信息

      查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

    • Escape 与 Native 编解码

      JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

    • JavaScript / HTML 格式化

      使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online