Windows (WSL2)

在 Windows 上推荐通过 WSL2 运行 OpenClaw（推荐 Ubuntu）。CLI + Gateway 运行在 Linux 内部，这样可以保持运行环境一致，让工具更兼容（Node/Bun/pnpm、Linux 二进制文件、Skill）。原生 Windows 可能会比较麻烦。WSL2 给你完整的 Linux 体验——只需一条命令就能安装：wsl --install。

原生 Windows 配套应用正在计划中。

安装 (WSL2)

Gateway

Gateway 服务安装 (CLI)

在 WSL2 内运行：

openclaw onboard --install-daemon

或者：

openclaw gateway install

或者：

openclaw configure

提示时选择 Gateway service。

修复/迁移：

openclaw doctor

高级：通过局域网暴露 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 允许局域网访问；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) 安装 OpenClaw（在 WSL 内）

在 WSL 内按照 Linux 快速开始流程操作：

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

完整指南：快速开始

Windows 配套应用

我们目前还没有 Windows 配套应用。如果你想帮忙实现，欢迎贡献代码。