Windows 上部署 OpenClaw

在 Windows 上部署 OpenClaw，主要有 WSL2 (官方推荐) ​ 和 原生 PowerShell​ 两种方式。您可以根据需求选择其一。

💡 部署方式对比

部署方式	优点	缺点	适用场景
WSL2 (推荐) ​	兼容性最佳，插件生态完整，官方主力支持。	需要开启虚拟化，占用稍多磁盘空间。	长期使用，希望获得完整体验的用户。
原生 PowerShell​	无需开启 WSL，步骤相对简单。	部分插件或功能可能不支持，需自行解决兼容性问题。	不想使用 WSL，进行简单功能体验的用户。

---

🐧 方式一：通过 WSL2 部署 (官方推荐)

1. 启用 WSL2

1. 以管理员身份打开 PowerShell，执行以下命令：

   powershell

   启用 WSL 和虚拟机平台

   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

2. 重启电脑。

3. 下载并安装 WSL2 内核更新包：

   👉 aka.ms/wsl2kernel

4. 将 WSL2 设为默认版本：

   powershell

   wsl --set-default-version 2

5. 安装 Ubuntu：

   powershell

   wsl --install -d Ubuntu-22.04

   安装后按提示设置用户名和密码。

2. 在 Ubuntu 中安装环境

1. 进入 Ubuntu 终端，更新系统并安装基础工具：

   bash

   sudo apt update && sudo apt upgrade -y

   sudo apt install -y curl git build-essential

2. 安装 Node.js 22+：

   bash

   curl -fsSL deb.nodesource.com/setup_22.x| sudo -E bash -

   sudo apt install -y nodejs

   node -v

   npm -v

   确保输出版本号 v22.x.x和 10.x.x或更高。

3. 安装 OpenClaw

在 Ubuntu 终端中，任选其一：

• 官方脚本一键安装

  bash

  curl -fsSL openclaw.ai/install.sh| bash

• 国内镜像安装 (速度更快)

  bash

  curl -fsSL clawd.org.cn/install.sh| bash

安装后执行 openclaw --version检查是否成功。

4. 初始化配置

1. 启动配置向导：

   bash

   openclaw onboard --install-daemon

2. 根据提示操作：

   • 输入 Yes确认风险。
   • 模式选择 QuickStart。
   • 模型提供商可先 Skip for now，后续在 Web 控制台配置。
   • 消息平台（飞书/企微等）也可先跳过。

3. 配置完成后，浏览器将自动打开 Web 控制台 http://127.0.0.1:18789/。

5. 访问 Web 控制台

• 方法一：在 WSL 中启动并指定端口。

  bash

  openclaw gateway run --port 18789

• 方法二：在 Windows 上创建批处理脚本 start-openclaw.bat。

  bat

  @echo off

  echo Starting OpenClaw Gateway in WSL2...

  wsl -d Ubuntu-22.04 -u root service openclaw start

  timeout /t 3

  start http://localhost:18789

  双击运行此脚本即可。

---

⚙️ 方式二：原生 PowerShell 部署

1. 安装 Node.js

1. 访问官网下载并安装 Node.js 22.x (LTS) ​ 版本：

   👉 nodejs.org/zh-cn/downl…

2. 安装时建议勾选“自动安装必要的工具”。

3. 打开 PowerShell 验证安装：

   powershell

   node -v

   npm -v

2. 安装 OpenClaw

1. 以管理员身份打开 PowerShell，设置执行策略：

   powershell

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 执行安装命令（二选一）：

   • 官方脚本

     powershell

     iwr -useb openclaw.ai/install.ps1| iex

   • 国内镜像

     powershell

     iwr -useb clawd.org.cn/install.ps1| iex

3. 安装后执行 openclaw --version检查是否成功。

3. 初始化配置

1. 启动配置向导：

   powershell

   openclaw onboard --install-daemon

2. 配置流程与 WSL2 方式基本一致，可先跳过模型和渠道配置，后续在 Web 控制台设置。

4. 访问 Web 控制台

脚本运行成功后，浏览器将自动打开 http://127.0.0.1:18789/。

---

🔧 常见问题与排错

• 权限错误：确保始终以 管理员身份​ 运行 PowerShell。
• 脚本执行被阻止：执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser命令。
• Node.js 版本错误：使用 nvm-windows或手动安装 Node.js 22+ ​ 版本。
• WSL2 启动失败：检查 BIOS 中虚拟化是否已开启，并确保已安装 WSL2 内核更新包。
• 服务未启动：使用 openclaw status或 openclaw doctor命令进行诊断。