跳轉到主要內容

​
Windows（WSL2）

OpenClaw on Windows is recommended via WSL2 (Ubuntu recommended). 在 Windows 上執行 OpenClaw 建議透過 WSL2（建議使用 Ubuntu）。該 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 有其自己的虛擬網路。 如果另一台機器需要存取 在 WSL 內部 執行的服務（SSH、本機 TTS 伺服器或 Gateway），你必須將 Windows 連接埠轉送到目前的 WSL IP。 WSL 有其自己的虛擬網路。 如果另一台機器需要存取 在 WSL 內部 執行的服務（SSH、本機 TTS 伺服器或 Gateway），你必須將 Windows 連接埠轉送到目前的 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 to make it happen. Contributions are welcome if you want contributions to make it happen.