Zum Hauptinhalt springen

​
Windows (WSL2)

OpenClaw unter Windows wird über WSL2 empfohlen (Ubuntu empfohlen). Die CLI + Gateway laufen innerhalb von Linux, was die Laufzeit konsistent hält und die Tooling‑Kompatibilität deutlich verbessert (Node/Bun/pnpm, Linux‑Binärdateien, Skills). Natives Windows kann kniffliger sein. WSL2 bietet Ihnen die vollständige Linux‑Erfahrung — ein Befehl zur Installation: wsl --install. Native Windows‑Companion‑Apps sind geplant.

​
Installation (WSL2)

​
Gateway

​
Gateway‑Dienst installieren (CLI)

Innerhalb von WSL2: 
openclaw onboard --install-daemon
Oder: 
openclaw gateway install
Oder: 
openclaw configure
Wählen Sie Gateway service, wenn Sie dazu aufgefordert werden. Reparieren/Migrieren: 
openclaw doctor

​
Erweitert: WSL‑Dienste über LAN verfügbar machen (portproxy)

WSL verfügt über ein eigenes virtuelles Netzwerk. Wenn ein anderes Gerät einen Dienst erreichen muss, der innerhalb von WSL läuft (SSH, ein lokaler TTS‑Server oder das Gateway), müssen Sie einen Windows‑Port an die aktuelle WSL‑IP weiterleiten. Die WSL‑IP ändert sich nach Neustarts, daher müssen Sie die Weiterleitungsregel ggf. 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 einmalig durch die Windows‑Firewall zulassen: 
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 Gerät 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); verwenden Sie openclaw status --all zur Bestätigung.
  • Verwenden Sie listenaddress=0.0.0.0 für LAN‑Zugriff; 127.0.0.1 hält es ausschließlich lokal.
  • Wenn Sie dies automatisieren möchten, registrieren Sie eine geplante Aufgabe, die den Aktualisierungsschritt bei der Anmeldung ausführt.

​
Schritt‑für‑Schritt‑WSL2‑Installation

​
1. WSL2 + Ubuntu installieren

Öffnen Sie PowerShell (Admin): 
wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04
Starten Sie neu, falls Windows dazu auffordert.

​
2. systemd aktivieren (erforderlich für die Gateway‑Installation)

In Ihrem WSL‑Terminal: 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
Dann aus PowerShell: 
wsl --shutdown
Öffnen Sie Ubuntu erneut und prüfen Sie anschließend: 
systemctl --user status

​
3. OpenClaw installieren (innerhalb von WSL)

Folgen Sie dem Linux‑Ablauf „Erste Schritte“ innerhalb von 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
Vollständige Anleitung: Erste Schritte

​
Windows‑Companion‑App

Wir haben derzeit noch keine Windows‑Companion‑App. Beiträge sind willkommen, wenn Sie mithelfen möchten, dies zu ermöglichen.