> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Windows (WSL2)

# 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)

* [Erste Schritte](/start/getting-started) (innerhalb von WSL verwenden)
* [Installation & Updates](/install/updating)
* Offizielle WSL2‑Anleitung (Microsoft): [https://learn.microsoft.com/windows/wsl/install](https://learn.microsoft.com/windows/wsl/install)

## Gateway

* [Gateway‑Runbook](/gateway)
* [Konfiguration](/gateway/configuration)

## 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**):

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
$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:

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
```

Portproxy nach WSL‑Neustarts aktualisieren:

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
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):

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
```

Dann aus PowerShell:

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
wsl --shutdown
```

Öffnen Sie Ubuntu erneut und prüfen Sie anschließend:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
systemctl --user status
```

### 3. OpenClaw installieren (innerhalb von WSL)

Folgen Sie dem Linux‑Ablauf „Erste Schritte“ innerhalb von WSL:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/start/getting-started)

## Windows‑Companion‑App

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