Windows (WSL2)

OpenClaw på Windows rekommenderas via WSL2 (Ubuntu rekommenderas). CLI + Gateway körs inuti Linux, vilket håller körtiden konsekvent och gör verktyg betydligt mer kompatibla (Node/Bun/pnpm, Linux-binärer, färdigheter). Inhemska Windows kan vara knepigare. WSL2 ger dig den fullständiga Linuxupplevelsen — ett kommando för att installera: wsl --install. Native Windows companion-appar är planerade.

Installera (WSL2)

Kom igång (använd inuti WSL)
Installera & uppdateringar
Officiell WSL2-guide (Microsoft): https://learn.microsoft.com/windows/wsl/install

Gateway

Installera Gateway-tjänst (CLI)

Inuti WSL2:

openclaw onboard --install-daemon

Eller:

openclaw gateway install

Eller:

openclaw configure

Välj Gateway service när du blir tillfrågad. Reparera/migrera:

openclaw doctor

Avancerat: exponera WSL-tjänster över LAN (portproxy)

WSL har ett eget virtuellt nätverk. Om en annan maskin behöver nå en tjänst som kör inuti WSL (SSH, en lokal TTS-server, eller Gateway), du måste vidarebefordra en Windows-port till den nuvarande WSL IP. WSL IP ändringarna efter omstarten, så du kan behöva uppdatera vidarebefordringsregeln. Exempel (PowerShell som administratör):

$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

Tillåt porten genom Windows-brandväggen (engångs):

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

Uppdatera portproxy efter att WSL startats om:

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

Noteringar:

SSH från en annan maskin riktar sig mot Windows-värdens IP (exempel: ssh user@windows-host -p 2222).
Fjärrnoder måste peka på en nåbar Gateway-URL (inte 127.0.0.1); använd openclaw status --all för att bekräfta.
Använd listenaddress=0.0.0.0 för LAN-åtkomst; 127.0.0.1 håller det endast lokalt.
Om du vill ha detta automatiskt, registrera en schemalagd aktivitet som kör uppdateringssteget vid inloggning.

Steg-för-steg WSL2-installation

1. Installera WSL2 + Ubuntu

Öppna PowerShell (Admin):

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

Starta om om Windows ber om det.

2. Aktivera systemd (krävs för Gateway-installation)

I din WSL-terminal:

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

Sedan från PowerShell:

wsl --shutdown

Öppna Ubuntu igen och verifiera:

systemctl --user status

3. Installera OpenClaw (inuti WSL)

Följ Linux-flödet för Kom igång inuti 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

Fullständig guide: Kom igång

Windows companion-app

Vi har inte en Windows följeslagare app än. Bidrag är välkomna om du vill att bidrag ska få det att hända.

Plattformsöversikt

macOS companion app

Windows (WSL2)

Windows (WSL2)

Installera (WSL2)

Gateway

Installera Gateway-tjänst (CLI)

Avancerat: exponera WSL-tjänster över LAN (portproxy)

Steg-för-steg WSL2-installation

1. Installera WSL2 + Ubuntu

2. Aktivera systemd (krävs för Gateway-installation)

3. Installera OpenClaw (inuti WSL)

Windows companion-app

​Windows (WSL2)

​Installera (WSL2)

​Gateway

​Installera Gateway-tjänst (CLI)

​Avancerat: exponera WSL-tjänster över LAN (portproxy)

​Steg-för-steg WSL2-installation

​1. Installera WSL2 + Ubuntu

​2. Aktivera systemd (krävs för Gateway-installation)

​3. Installera OpenClaw (inuti WSL)

​Windows companion-app

Windows (WSL2)

Installera (WSL2)

Gateway

Installera Gateway-tjänst (CLI)

Avancerat: exponera WSL-tjänster över LAN (portproxy)

Steg-för-steg WSL2-installation

1. Installera WSL2 + Ubuntu

2. Aktivera systemd (krävs för Gateway-installation)

3. Installera OpenClaw (inuti WSL)

Windows companion-app