Windows（WSL2）

?Windows 上推?通过 WSL2*（推?Ubuntu）运?OpenClaw。CLI + Gateway ?Linux 内部运行，这保持运行时一致并使工具更加兼容（Node/Bun/pnpm、Linux 二进制、技能）。原?Windows 可能更复杂。WSL2 给您完整?Linux 体验 —?一条命令安装：wsl --install?

计划推出原生 Windows 配套应用?

安装（WSL2?

Gateway

Gateway 服务安装（CLI?

?WSL2 内：

openclaw onboard --install-daemon

或者：

openclaw gateway install

或者：

openclaw configure

出现提示时选择 Gateway 服务?

修复/迁移?

openclaw doctor

高级：通过 LAN 公开 WSL 服务（portproxy?

WSL 有自己的虚拟网络。如果另一台机器需要访?*?WSL ?*运行的服务（SSH、本?TTS 服务器或 Gateway），您必须将 Windows 端口转发到当?WSL IP。WSL IP 在重启后可能改变，因此您可能需要刷新转发规则?

示例（PowerShell 以管理员身份）：

$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "WSL IP not found." }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort

允许端口通过 Windows 防火墙（一次性）?

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

WSL 重启后刷?portproxy?

netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null

注意?

  • 从另一台机?SSH 指向Windows 主机 IP（示例：ssh user@windows-host -p 2222）?
  • 远程节点必须指向**可到?*?Gateway URL（不?127.0.0.1）；使用 openclaw status --all 确认?
  • 使用 listenaddress=0.0.0.0 用于 LAN 访问；127.0.0.1 保持仅本地?
  • 如果您希望自动运行，请在登录时运行刷新步骤的已计划任务?

逐步 WSL2 安装

1) 安装 WSL2 + Ubuntu

以管理员身份打开 PowerShell?

wsl --install
# 或明确选择发行版：
wsl --list --online
wsl --install -d Ubuntu-24.04

如果 Windows 要求则重启?

2) 启用 systemd（Gateway 安装所需?

在您?WSL 终端中：

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

然后?PowerShell?

wsl --shutdown

重新打开 Ubuntu，然后验证：

systemctl --user status

3) ?WSL 内安?OpenClaw

?WSL 内遵?Linux 快速开始流程：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次运行时自动安?UI 依赖
pnpm build
openclaw onboard

完整指南：快速开始

Windows 配套应用

我们还没?Windows 配套应用。如果您想贡献，欢迎参与开发?