Windows (WSL2)

OpenClaw auf Windows wird über WSL2 empfohlen (Ubuntu empfohlen). Die CLI + Gateway laufen in Linux, was die Runtime konsistent hält und die Tooling-Kompatibilität deutlich verbessert (Node/Bun/pnpm, Linux-Binaries, Skills). Natives Windows kann komplizierter sein. WSL2 gibt dir die volle Linux-Erfahrung — ein Befehl zur Installation: wsl --install.

Native Windows Companion Apps sind geplant.

Installation (WSL2)

Gateway

Gateway Service installieren (CLI)

Innerhalb von WSL2:

openclaw onboard --install-daemon

Oder:

openclaw gateway install

Oder:

openclaw configure

Wähle Gateway service aus, wenn du dazu aufgefordert wirst.

Reparieren/Migrieren:

openclaw doctor

Fortgeschritten: WSL-Services über LAN verfügbar machen (portproxy)

WSL hat sein eigenes virtuelles Netzwerk. Wenn ein anderer Rechner auf einen Service zugreifen muss, der innerhalb von WSL läuft (SSH, ein lokaler TTS-Server oder das Gateway), musst du einen Windows-Port zur aktuellen WSL-IP weiterleiten. Die WSL-IP ändert sich nach Neustarts, daher musst du die Weiterleitungsregel möglicherweise aktualisieren.

Beispiel (PowerShell als 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

Port durch die Windows Firewall erlauben (einmalig):

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

Portproxy nach WSL-Neustarts aktualisieren:

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

Hinweise:

  • SSH von einem anderen Rechner zielt auf die Windows Host-IP (Beispiel: ssh user@windows-host -p 2222).
  • Remote-Nodes müssen auf eine erreichbare Gateway-URL zeigen (nicht 127.0.0.1); nutze openclaw status --all zur Bestätigung.
  • Verwende listenaddress=0.0.0.0 für LAN-Zugriff; 127.0.0.1 hält es nur lokal.
  • Wenn du das automatisieren möchtest, registriere eine geplante Aufgabe, die den Aktualisierungsschritt beim Login ausführt.

Schritt-für-Schritt WSL2-Installation

1) WSL2 + Ubuntu installieren

Öffne PowerShell (Admin):

wsl --install
# Oder wähle explizit eine Distribution:
wsl --list --online
wsl --install -d Ubuntu-24.04

Starte neu, wenn Windows dich dazu auffordert.

2) systemd aktivieren (erforderlich für Gateway-Installation)

In deinem WSL-Terminal:

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

Dann in PowerShell:

wsl --shutdown

Öffne Ubuntu erneut und überprüfe:

systemctl --user status

3) OpenClaw installieren (innerhalb von WSL)

Folge dem Linux Getting Started Flow innerhalb von WSL:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # installiert UI-Abhängigkeiten beim ersten Durchlauf automatisch
pnpm build
openclaw onboard

Vollständiger Guide: Getting Started

Windows Companion App

Wir haben noch keine Windows Companion App. Beiträge sind willkommen, wenn du dabei helfen möchtest.