Clawdbot Windows (WSL2) Einrichtung

Clawdbot Windows-Übersicht

Clawdbot auf Windows wird über WSL2 empfohlen (Ubuntu empfohlen). Das CLI + Gateway laufen innerhalb von Linux, was die Laufzeitumgebung konsistent hält und die Werkzeugkompatibilität erheblich verbessert.

Natives Windows kann schwieriger sein. WSL2 gibt Ihnen die vollständige Linux-Erfahrung — ein Befehl zur Installation: wsl --install.

Native Windows-Begleit-Apps sind geplant.

Installation (WSL2)

Schritt 1: WSL2 + Ubuntu installieren

Öffnen Sie PowerShell (Admin):

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

Starten Sie neu, wenn Windows dazu auffordert.

Schritt 2: systemd aktivieren (Erforderlich)

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 überprüfen Sie:

systemctl --user status

Schritt 3: Clawdbot installieren (In WSL)

Folgen Sie dem Linux-Erste-Schritte-Ablauf in WSL:

# Option 1: Schnellinstallation
curl -fsSL https://clawd.bot/install.sh | bash

# Option 2: Aus dem Quellcode
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

Gateway-Dienst-Installation (CLI)

Innerhalb von WSL2:

# Option 1
clawdbot onboard --install-daemon

# Option 2
clawdbot gateway install

# Option 3
clawdbot configure
# Wählen Sie "Gateway service" wenn aufgefordert

Reparieren/Migrieren:

clawdbot doctor

WSL-Dienste über LAN freigeben (Fortgeschritten)

WSL hat sein eigenes virtuelles Netzwerk. Wenn ein anderer Rechner auf einen Dienst zugreifen muss, der in WSL läuft, müssen Sie einen Windows-Port zur aktuellen WSL-IP weiterleiten.

Hinweis: Die WSL-IP ändert sich nach Neustarts, daher müssen Sie möglicherweise die Weiterleitungsregel 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

Durch Firewall zulassen (Einmalig)

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

Nach WSL-Neustart 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 (z.B. ssh user@windows-host -p 2222)
• Verwenden Sie listenaddress=0.0.0.0 für LAN-Zugriff; 127.0.0.1 hält es lokal
• Für automatische Aktualisierung registrieren Sie eine Geplante Aufgabe, die bei der Anmeldung ausgeführt wird

Gateway-Konfiguration

Siehe die Hauptanleitungen:

• Gateway-Handbuch
• Gateway-Konfiguration

Gesundheitsprüfungen

clawdbot status
clawdbot health
clawdbot doctor

Windows-Begleit-App

Wir haben noch keine Windows-Begleit-App. Beiträge sind willkommen.

Nächste Schritte

• Clawdbot macOS - macOS-Einrichtung
• Clawdbot Linux - Linux-Einrichtung
• Clawdbot Gateway - Gateway-Konfiguration