OpenClaw auf Windows mit WSL2 einrichten

Die Entwicklung auf Windows kann frustrierend sein, wenn Tools eigentlich für Linux optimiert sind. Oft verbringst du mehr Zeit mit der Fehlerbehebung der Umgebung oder inkompatiblen Pfaden als mit dem eigentlichen Projekt. Das hält dich auf und nervt.

Ich empfehle dir für OpenClaw auf Windows den Weg über WSL2 (am besten mit Ubuntu). Da das CLI und das Gateway innerhalb von Linux laufen, bleibt die Runtime konsistent. Tooling wie Node.js, Bun oder pnpm sowie Linux-Binaries funktionieren dort einfach ohne Probleme. Native Windows-Apps sind zwar geplant, aber WSL2 bietet dir heute die stabilste Erfahrung.

What You’ll Need

• WSL2 (Ubuntu-Distribution empfohlen)
• PowerShell mit Administrator-Rechten
• Offizieller Microsoft Guide: WSL-Installation

Quick Start

In fünf Minuten ist OpenClaw in deiner WSL2-Umgebung startklar.

1. WSL2 installieren: Öffne die PowerShell als Administrator und führe wsl --install aus.
2. Systemd aktivieren: Erstelle die /etc/wsl.conf in deinem WSL-Terminal mit systemd=true.
3. OpenClaw installieren: Klone das Repo, installiere die Abhängigkeiten mit pnpm install und baue das Projekt.
4. Onboarding: Starte openclaw onboard, um alles zu konfigurieren.

Schritt-für-Schritt-Installation

1. WSL2 und Ubuntu vorbereiten

Öffne die PowerShell als Administrator:

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

Starte deinen Rechner neu, falls Windows dich dazu auffordert.

2. Systemd aktivieren

Das Gateway benötigt systemd. Führe diesen Befehl in deinem WSL-Terminal aus:

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

Starte WSL danach über die PowerShell neu:

wsl --shutdown

Prüfe den Status nach dem Neustart in Ubuntu:

systemctl --user status

3. OpenClaw in WSL installieren

Nutze den Linux-Workflow innerhalb deiner WSL-Umgebung:

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

Gateway Service Installation

Du kannst den Gateway-Dienst direkt über das CLI in WSL2 einrichten:

openclaw onboard --install-daemon
# Alternativ:
openclaw gateway install
# Oder:
openclaw configure

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

Fortgeschritten: WSL-Dienste im LAN freigeben (portproxy)

WSL nutzt ein eigenes virtuelles Netzwerk. Wenn andere Geräte im LAN (z. B. ein TTS-Server oder das Gateway) zugreifen sollen, musst du einen Windows-Port an die WSL-IP weiterleiten. Da sich die WSL-IP nach Neustarts ändert, muss die Regel aktualisiert werden.

Nutze dieses PowerShell-Skript (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 nicht gefunden." }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort

Gib den Port einmalig in der Windows-Firewall frei:

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

Um den Portproxy nach einem WSL-Neustart zu 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-Zugriff erfolgt über die Windows-Host-IP (z. B. ssh user@windows-host -p 2222).
• Remote-Nodes müssen eine erreichbare Gateway-URL nutzen (nicht 127.0.0.1). Prüfe dies mit openclaw status --all.

Troubleshooting

• Reparatur: Falls etwas nicht funktioniert, hilft oft openclaw doctor, um die Installation zu prüfen oder zu migrieren.
• Verbindungsprobleme: Wenn das Gateway von außen nicht erreichbar ist, prüfe, ob listenaddress=0.0.0.0 im Portproxy gesetzt ist. 127.0.0.1 erlaubt nur lokale Zugriffe.

Brauchst du Hilfe bei einem spezifischen Fehler? Frag den AI Setup Assistant.

What’s Next

• Getting Started
• Gateway Runbook
• Gateway Konfiguration
• Install & Updates