概述

要在 Windows 上跑 OpenClaw，走 WSL2 几乎是最省心的选择。项目官方强烈推荐使用 Ubuntu 发行版作为运行环境。

把 CLI 和 Gateway 都放在 Linux 里运行，既能保证环境一致性，也能让 Node/Bun/pnpm 这些工具链、Linux 二进制文件以及技能包的兼容性更稳定。

有人可能会问：原生 Windows 支持不好吗？只能说，不是不行，但复杂度会高不少。

而且目前官方也在排期做原生的 Windows 配套应用。现阶段，用 WSL2 可以获得完整的 Linux 体验，安装也只需要一条命令。

第一步：安装 WSL2 和 Ubuntu

1.1 快速安装

以管理员身份打开 PowerShell，直接运行这条命令：

wsl --install

如果你对发行版有特定偏好，比如 Ubuntu 24.04，可以这样操作：

# 先看看有哪些发行版可选
wsl --list --online
# 指定版本安装
wsl --install -d Ubuntu-24.04

1.2 重启系统

如果 Windows 提示需要重启，就按提示重启一次，让 WSL2 完成安装。

1.3 首次启动配置

重启完成后，从开始菜单启动 Ubuntu。系统会引导你完成两项基础操作：

• 创建一个 Linux 用户名
• 设置对应的密码

完成后，你就已经进入 Ubuntu 终端了。

第二步：启用 systemd

这一步很关键。OpenClaw 的 Gateway 服务需要 systemd 支持。

2.1 配置 WSL

在 Ubuntu 终端里执行：

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

2.2 重启 WSL

回到 Windows PowerShell 执行：

wsl --shutdown

2.3 验证 systemd

重新打开 Ubuntu 终端，检查 systemd 是否正常运行：

systemctl --user status

如果能看到服务列表输出，说明配置已经生效。

第三步：安装 OpenClaw

3.1 克隆仓库

在 WSL Ubuntu 终端中执行：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

3.2 安装依赖

pnpm install

3.3 构建 UI

pnpm ui:build  # 首次运行会自动安装 UI 依赖

3.4 构建项目

pnpm build

3.5 初始化配置

openclaw onboard

按照交互式提示完成初始配置。

第四步：安装 Gateway 服务

Gateway 是 OpenClaw 的核心服务组件。安装方式有几种，可以按实际情况选择。

方式一：自动安装（推荐）

openclaw onboard --install-daemon

方式二：直接安装

openclaw gateway install

方式三：通过配置向导

openclaw configure

在提示时选择 “Gateway service”。

修复或迁移

如果遇到问题，可以先运行诊断工具：

openclaw doctor

高级配置：局域网访问（可选）

为什么需要端口转发？

WSL2 有自己独立的虚拟网络，和 Windows 主机网络是隔离的。

如果你希望从局域网内的其他设备访问 WSL 里运行的服务，比如 SSH、本地 TTS 服务器或者 Gateway，就必须把 Windows 的端口转发到 WSL 的 IP 地址。

注意：WSL 的 IP 地址每次重启都会变，所以转发规则也需要跟着刷新。

配置端口转发

以管理员身份打开 PowerShell，执行以下脚本：

# 配置参数
$Distro = "Ubuntu-24.04"
$ListenPort = 2222  # Windows 监听端口
$TargetPort = 22    # WSL 内目标端口
# 获取 WSL IP 地址
$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "无法获取 WSL IP 地址" }
# 添加端口转发规则
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort

配置防火墙规则（一次性）

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow

WSL 重启后刷新转发

每次 WSL 重启后，都需要重新配置端口转发规则：

# 删除旧规则
netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
# 重新获取 IP 并添加规则
$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null

重要提示

• 局域网访问：使用 listenaddress=0.0.0.0 表示允许局域网内任意设备访问；如果只想本机访问，改成 127.0.0.1 即可
• 远程连接示例：ssh user@windows-host -p 2222（连接时用的是 Windows 主机的 IP 地址）
• Gateway 配置：远程节点必须指向一个可访问的 Gateway URL，不能用 127.0.0.1。可以用 openclaw status --all 确认配置是否正确
• 自动化：可以设置一个 Windows 计划任务，在登录时自动运行刷新脚本，省心很多

验证安装

检查服务状态

openclaw status --all

查看 Gateway 状态

systemctl --user status openclaw-gateway

查看日志

journalctl --user -u openclaw-gateway -f

常见问题

WSL2 安装失败？

先确认你的 Windows 版本是否支持 WSL2。Windows 10 版本 2004 及以上，或者 Windows 11 都没问题。

systemd 无法启动？

检查 /etc/wsl.conf 配置是否写对了，然后别忘了执行 wsl --shutdown 让配置生效。

端口转发不工作？

• 确认 Windows 防火墙规则已经添加
• 检查 WSL IP 地址是否正确：wsl -- hostname -I
• 用 netsh interface portproxy show all 查看当前的转发规则

Gateway 服务无法启动？

直接运行诊断工具：

openclaw doctor