Skip to main content

​
Windows (WSL2)

推荐通过 WSL2（推荐使用 Ubuntu）在 Windows 上运行 OpenClaw。
CLI 和网关运行在 Linux 内部，这既保持了运行时的一致性，也使工具兼容性更好（Node/Bun/pnpm，Linux 二进制文件，技能支持）。
原生 Windows 可能会更棘手。WSL2 给你完整的 Linux 体验——只需一条命令安装：wsl --install。 计划推出原生 Windows 伴侣应用。

​
安装（WSL2）

​
网关

​
网关服务安装（CLI）

在 WSL2 内执行： 
openclaw onboard --install-daemon
或者： 
openclaw gateway install
或者： 
openclaw configure
出现提示时，选择 网关服务。 修复/迁移： 
openclaw doctor

​
网关开机自动启动（Windows 登录前）

针对无头配置，确保即使无人登录 Windows，整个启动链也能正常运行。

​
1) 无登录时保持用户服务运行

在 WSL 内执行： 
sudo loginctl enable-linger "$(whoami)"

​
2) 安装 OpenClaw 网关用户服务

在 WSL 内执行： 
openclaw gateway install

​
3) 在 Windows 启动时自动开始 WSL

以管理员身份打开 PowerShell 执行： 
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM
将 Ubuntu 替换成你的发行版名，可通过以下命令查看： 
wsl --list --verbose

​
验证启动链

重启后（Windows 登录前），在 WSL 中检查： 
systemctl --user is-enabled openclaw-gateway
systemctl --user status openclaw-gateway --no-pager

​
高级：通过局域网暴露 WSL 服务（端口代理）

WSL 有自己的虚拟网络。如果其他机器需要访问 WSL 内运行的服务（如 SSH、本地 TTS 服务器或网关），需将 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 未找到。" }

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 重启后刷新端口代理规则： 
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）。
  • 远程节点必须指向可访问的网关 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（安装网关所需）

在 WSL 终端执行： 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
然后在 PowerShell 中执行： 
wsl --shutdown
重新打开 Ubuntu，验证： 
systemctl --user status

​
3) 安装 OpenClaw（WSL 内）

按照 Linux 快速入门流程在 WSL 中执行： 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次运行时自动安装 UI 依赖
pnpm build
openclaw onboard
完整指南见：快速入门

​
Windows 伴侣应用

目前尚无 Windows 伴侣应用。如果你有兴趣贡献代码，欢迎参与开发。