Win10系统部署OpenClaw

7 阅读2分钟

在 Windows 10 上安装 OpenClaw,推荐采用‌手动安装方式‌,以避免自动化脚本因网络、权限或环境问题导致失败。


一、安装前准备

  • 系统要求‌:Windows 10 64位(推荐 22H2 或更高版本)、至少 8GB 内存、稳定网络。
  • 关键依赖‌:Node.js(≥ v22.22)、Git、管理员权限 PowerShell。

二、详细安装步骤

  1. 安装 Node.js(必须 ≥ v22.22)

    • 参考上一篇文章地址,使用nvm安装nodeJs,便于管理。传送门:NodeJS:使用nvm管理node版本

    • 如安装版本:24.13.1 (nvm install 24.13.1)

    • 验证安装:

      node -v
      npm -v
      

      输出应分别为 v22.x.x 或更高、10.x.x 左右。

  2. 安装 Git

    • 下载地址:Git for Windows

    • 安装时注意:

      • 在 ‌ “Choosing the default editor” ‌ 步骤保持默认。

      • 在 ‌ “Adjusting your PATH environment” ‌ 步骤选择:

        Git from the command line and also from 3rd-party software

    • 验证安装:

      git --version
      
  3. 配置 PowerShell 执行策略(关键!)

    • 以‌管理员身份‌打开 PowerShell(后续全程使用powershell),执行:

      Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
      

      输入 Y 确认。

  4. 安装 OpenClaw

    • 推荐使用国内镜像加速(避免 GitHub 访问慢):

      npm config set registry https://registry.npmmirror.com
      npm install -g openclaw@latest
      
    • 验证安装:

      openclaw --version
      
  5. 初始化配置

    • 运行引导向导:

      openclaw onboard --install-daemon
      
    • 按提示操作:

      • I understand this is powerful... → 选 ‌yes
      • Onboarding mode → 选 ‌QuickStart
      • 大模型选择 → 国内用户可选 ‌Qwen(通义千问) ‌ 或 ‌Minimax‌(首次有免费额度)
      • 通道(Channels)→ 首次可选 ‌Skip for now
      • Skill/Hooks → 选 ‌Skip for now
      • 启动方式 → 选 ‌Open the Web UI
  6. 访问 Web 控制台

    • 安装成功后,浏览器会自动打开:

      http://127.0.0.1:18789
      
    • 若未自动打开,可手动运行:

      openclaw dashboard
      

三、验证是否安装成功

在 PowerShell 中执行以下命令,若返回对应结果即成功:

openclaw --version
openclaw gateway health

输出中包含 Gateway Health OK 表示服务正常运行。

在使用过程中请保持PowerShell处于打开状态,且不要关闭cmd页面。若不小心关闭,或关机后再次使用,可在powershell中执行以下指令以启动OpenClaw:

openclaw dashboard
openclaw gateway start

四、后续建议

  • 接入飞书/钉钉‌:可在 Web UI 中输入“请帮我配置飞书机器人”,OpenClaw 会引导完成。

  • 隐私提示‌:OpenClaw 需要较高系统权限,‌建议在无敏感数据的设备上使用‌ ‌。

  • 卸载命令‌(如需):

    openclaw uninstall --all --yes --non-interactive
    npm uninstall -g openclaw
    

以上方法优先采用‌手动、可验证、低风险‌的路径,适合 Win10 原生环境部署。亲测有效,安装完再安装其他skill。

image.png