跳转到主要内容

​
Windows (WSL2)

Windows 上的 OpenClaw 推荐通过 WSL2（推荐 Ubuntu）。CLI + Gateway 网关在 Linux 内运行，这保持了运行时的一致性并使工具兼容性大大提高（Node/Bun/pnpm、Linux 二进制文件、Skills）。原生 Windows 可能更棘手。WSL2 给你完整的 Linux 体验——一条命令安装：wsl --install。 The CLI + Gateway run inside Linux, which keeps the runtime consistent and makes tooling far more compatible (Node/Bun/pnpm, Linux binaries, skills). Native Windows might be trickier. WSL2 gives you the full Linux experience — one command to install: wsl --install. 原生 Windows 配套应用已在计划中。

​
安装（WSL2）

​
Gateway 网关

​
Gateway 网关服务安装（CLI）

在 WSL2 内： 
openclaw onboard --install-daemon
或： 
openclaw gateway install
或： 
openclaw configure
出现提示时选择 Gateway service。 修复/迁移： 
openclaw doctor

​
高级：通过 LAN 暴露 WSL 服务（portproxy）

WSL has its own virtual network. WSL 有自己的虚拟网络。如果另一台机器需要访问在 WSL 内运行的服务（SSH、本地 TTS 服务器或 Gateway 网关），你必须将 Windows 端口转发到当前的 WSL IP。WSL IP 在重启后会改变，因此你可能需要刷新转发规则。 The WSL IP changes after restarts, so you may need to refresh the forwarding rule. 示例（以管理员身份运行 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
# Or pick a distro explicitly:
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 # auto-installs UI deps on first run
pnpm build
openclaw onboard
完整指南：入门指南

​
Windows 配套应用

我们还没有 Windows 配套应用。如果你想让它实现，欢迎贡献。 Contributions are welcome if you want contributions to make it happen.