Windows (WSL2)¶

Inirerekomenda ang OpenClaw sa Windows sa pamamagitan ng WSL2 (inirerekomenda ang Ubuntu). The CLI + Gateway run inside Linux, which keeps the runtime consistent and makes tooling far more compatible (Node/Bun/pnpm, Linux binaries, skills). Maaaring mas mahirap ang native Windows. WSL2 gives you the full Linux experience — one command to install: wsl --install.

Pinaplano ang mga native Windows companion app.

Pag-install (WSL2)¶

• Pagsisimula (gamitin sa loob ng WSL)
• Install at mga update
• Opisyal na WSL2 guide (Microsoft): https://learn.microsoft.com/windows/wsl/install

Gateway¶

• Runbook ng Gateway
• Konpigurasyon

Pag-install ng serbisyo ng Gateway (CLI)¶

Sa loob ng WSL2:

openclaw onboard --install-daemon

O kaya:

openclaw gateway install

O kaya:

openclaw configure

Piliin ang Gateway service kapag na-prompt.

Ayusin/migrate:

openclaw doctor

Advanced: i-expose ang mga WSL service sa LAN (portproxy)¶

May sarili itong virtual network ang WSL. If another machine needs to reach a service running inside WSL (SSH, a local TTS server, or the Gateway), you must forward a Windows port to the current WSL IP. The WSL IP changes after restarts, so you may need to refresh the forwarding rule.

Halimbawa (PowerShell bilang Administrator):

$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

Payagan ang port sa Windows Firewall (isang beses lang):

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

I-refresh ang portproxy pagkatapos mag-restart ang 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

Mga tala:

• Ang SSH mula sa ibang machine ay tumatarget sa Windows host IP (halimbawa: ssh user@windows-host -p 2222).
• Dapat ituro ng mga remote node ang isang naaabot na Gateway URL (hindi 127.0.0.1); gamitin ang openclaw status --all para mag-confirm.
• Gamitin ang listenaddress=0.0.0.0 para sa LAN access; pinapanatiling lokal lang ng 127.0.0.1.
• Kung gusto mo itong awtomatiko, mag-register ng Scheduled Task para patakbuhin ang refresh step sa login.

Step-by-step na WSL2 install¶

1. I-install ang WSL2 + Ubuntu¶

Buksan ang PowerShell (Admin):

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

Mag-reboot kung hihingin ng Windows.

2. I-enable ang systemd (kinakailangan para sa Gateway install)¶

Sa iyong WSL terminal:

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

Pagkatapos, mula sa PowerShell:

wsl --shutdown

Buksan muli ang Ubuntu, saka i-verify:

systemctl --user status

3. I-install ang OpenClaw (sa loob ng WSL)¶

Sundin ang Linux Getting Started flow sa loob ng WSL:

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

Buong gabay: Pagsisimula

Kasamang app para sa Windows¶

Wala pa kaming Windows companion app sa ngayon. Malugod naming tinatanggap ang mga kontribusyon kung gusto mong tumulong para mangyari ito.