ClawCN - OpenClaw 中文版

主题

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 service。

修复/迁移:

openclaw doctor

高级:通过 LAN 暴露 WSL 服务 (portproxy) ​

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

示例(PowerShell 以管理员身份运行):

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 防火墙(一次性操作):

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

WSL 重启后刷新 portproxy:

powershell
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(管理员):

powershell
wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04

如果 Windows 要求重启,请重启。

2) 启用 systemd(gateway 安装所需) ​

在您的 WSL 终端中:

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

然后在 PowerShell 中:

powershell
wsl --shutdown

重新打开 Ubuntu,然后验证:

bash
systemctl --user status

3) 安装 OpenClaw(在 WSL 内) ​

在 WSL 内按照 Linux 快速入门流程操作:

bash
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 配套应用。如果您想为此做出贡献,欢迎贡献代码使其实现。