OpenClaw auf Windows einrichten

Zielgruppe: Absolute Anfänger — kein PowerShell-Wissen nötig

Dauer: 25 Minuten (+ optional 30-90 Min Skills)

Schwierigkeit: Anfänger

System: Windows 10/11 mit WSL2 (Linux auf Windows)

Version: v3 (endgültig validiert)

⚠️ Sicherheitshinweis: OpenClaw hat Zugriff auf Dateien und kann Befehle ausführen. Diese Anleitung funktioniert auf deinem Mac/PC — wir empfehlen aber die Installation auf einem VPS oder einem separaten Gerät durchzuführen.

Was ist WSL2?

WSL2 = Linux läuft INNERHALB von Windows — das macht OpenClaw stabiler und einfacher.

Wenn du Windows XP/7 hast: Das funktioniert nicht. Du brauchst Windows 10+ mit WSL2-Support.

Schritt 0: WSL2 + Node.js installieren

FENSTER 1: PowerShell (Administrator)

1. Drücke Windows-Taste + X
2. Klick auf "PowerShell (Administrator)" oder "Terminal (Administrator)"
3. Ein blaues Fenster öffnet sich

Im PowerShell-Fenster, tippe:

wsl --install

Drücke Enter.

Was passiert:

• Windows lädt Ubuntu (Linux) herunter — 5-15 Minuten
• Am Ende fragt es: "Restart now?"
• Klick "Restart now" oder tippe y
• PC startet neu

Nach Neustart: Ubuntu-Setup

Nach Neustart öffnet sich automatisch ein schwarzes Ubuntu-Fenster.

Es fragt:

Enter new UNIX username:

Tippe einen Namen (z.B. max) und drücke Enter.

Dann:

New password:

Tippe ein Passwort (wird nicht angezeigt — normal) und drücke Enter.

Bestätige mit Enter nochmal.

Perfekt! WSL2 ist installiert.

Node.js in Ubuntu installieren

Das Ubuntu-Fenster sollte noch offen sein.

Tippe:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

Drücke Enter. Es könnte dein Passwort fragen (das von oben).

Danach:

sudo apt-get install -y nodejs

Drücke Enter.

Das dauert 3-5 Minuten.

Überprüfe Node.js

Im Ubuntu-Fenster:

node --version

Du solltest sehen: v22.x.x

Perfekt!

Schritt 1: OpenClaw installieren

Wichtig: Bleib im Ubuntu-Fenster (nicht PowerShell).

Tippe:

curl -fsSL https://openclaw.ai/install.sh | bash

Drücke Enter.

Installation läuft 3-5 Minuten. Am Ende siehst du:

Installation complete!

Schritt 2: Konfigurieren

Im Ubuntu-Fenster:

openclaw configure

Drücke Enter.

FENSTER 1: Gateway-Ort

Where will the Gateway run?
● Local (this machine)
○ Remote (info-only)

Local ist schon markiert. Drücke Enter.

FENSTER 2: Was möchtest du konfigurieren?

Select sections to configure

● Workspace
○ Model
○ Web tools
○ Gateway
○ Daemon
○ Channels (Link WhatsApp/Telegram/etc)
○ Skills
○ Health check
○ Continue

Der Cursor (●) steht auf Workspace. Navigiere mit der Pfeiltaste (↓) nach unten zu Model und drücke Enter.

FENSTER 3: KI-Anbieter wählen

Model/auth provider

○ OpenAI (ChatGPT)
○ Anthropic (Claude)
○ Google (Gemini)
○ vLLM (Local)
... (viele mehr)

Wichtig: OAuth vs API-Key

OAuth (empfohlen) — KOSTENLOS mit bestehendem Abo

• OpenAI (ChatGPT): Du brauchst ChatGPT Pro Abo (€20/Monat)

- OpenClaw nutzt dein bestehendes Abo — kein extra API-Key nötig

- Du zahlst NICHT extra

API-Key — KOSTENPFLICHTIG

• Google, andere: Kosten Geld pro API-Call

Anfänger-Empfehlung:

Wenn du ChatGPT Pro hast: Wähle OpenAI → OAuth-Login, kein API-Key nötig

Wenn du nichts hast: Einfachste Option ist Google Gemini (kostenloser API-Key via Google AI Studio)

Markiere mit Pfeiltaste (nach oben/nach unten) und drücke Enter.

FENSTER 4: Login (OAuth)

Dein Browser (Windows-Browser, nicht Ubuntu!) öffnet sich.

Für OpenAI:

1. Melde dich mit deinem ChatGPT-Konto an
2. Gib OpenClaw Erlaubnis
3. Browser schließt automatisch
4. Ubuntu-Fenster zeigt: "Auth successful"

FENSTER 2 (zurück): Weitere Konfiguration?

Select sections to configure

● Workspace
○ Model (fertig)
○ Web tools
○ Gateway
○ Daemon
○ Channels (WhatsApp/Telegram/etc)
○ Skills
○ Health check
○ Continue

Optionen:

Option A: Nur Dashboard (schnell)

• Markiere Continue und drücke Enter
• OpenClaw läuft sofort

Option B: WhatsApp jetzt verbinden (10 Min mehr)

• Markiere Channels und drücke Enter
• Folge unten

Option C: Skills installieren (30-90+ Min, optional)

• Warnung: Windows ist noch langsamer als Mac!
• Viele können fehlschlagen — das ist NORMAL

(Optional) WhatsApp verbinden

Falls du Channels wählst (gleich wie Mac):

FENSTER 3: Channel-Status

Du siehst:

Channel status

Telegram: needs token
WhatsApp (default): not linked
Discord: needs token
...

Markiere WhatsApp und drücke Enter.

FENSTER 4-7: WhatsApp Setup

(Gleich wie Mac — siehe Schritt 2, FENSTER 4-7 in der Mac-Anleitung)

1. Configure/link wählen
2. WhatsApp wählen
3. QR-Code mit Handy scannen (WhatsApp → Verknüpfte Geräte → QR)
4. Deine Nummer eingeben (+43...)
5. Fertig!

FENSTER 2 (zurück): Continue

Markiere Continue und drücke Enter.

Schritt 3: Dashboard öffnen

Im Ubuntu-Fenster:

openclaw dashboard

Drücke Enter.

Dein Windows-Browser öffnet sich mit:

http://127.0.0.1:18789/

Du siehst das Chat-Fenster — dein KI-Assistent!

Schritt 4: Test-Nachricht

1. Klick ins Chat-Fenster
2. Tippe: "Hallo!"
3. Drücke Enter

Du bekommst eine Antwort!

Schritt 5: Updates

Im Dashboard:

Update available: v2026.3.13

Klick drauf. OpenClaw wird aktualisiert (30 Sekunden).

Schritt 6: WhatsApp nutzen

Falls verbunden:

Öffne WhatsApp auf deinem Handy und schreib:

"Was kannst du tun?"

OpenClaw antwortet direkt!

Häufige Windows-Fehler & Lösungen

Fehler 1: "WSL2 installation failed"

Lösung:

1. Drücke Windows-Taste + X
2. Klick "Systemeinstellungen"
3. Geh zu "Apps" → "Apps & Features" → "Optionale Features"
4. Klick "Weitere Features"
5. Suche "Windows-Subsystem für Linux"
6. Haken setzen
7. OK klicken
8. PC neu starten
9. Versuche wsl --install nochmal

Fehler 2: "Ubuntu window won't open"

Lösung:

1. Drücke Windows-Taste + X
2. Klick "Terminal (Administrator)"
3. Es sollte einen "Ubuntu" Tab geben
4. Falls nicht: Klick "+" und wähle "Ubuntu"

Fehler 3: "curl: command not found"

In Ubuntu-Fenster:

sudo apt-get update
sudo apt-get install curl -y

Fehler 4: "command not found: openclaw"

Lösung:

source ~/.bashrc

Oder: Ubuntu-Fenster schließen und neu öffnen.

Fehler 5: "WhatsApp not found" beim Channels-Setup

Das ist normal bei älteren Setups.

Versuche nochmal: openclaw configure → Channels

Fehler 6: "localhost:18789 funktioniert nicht"

Lösung (im Ubuntu-Fenster):

openclaw gateway restart

Warte 5 Sekunden, versuche nochmal.

Fehler 7: "running scripts is disabled on this system" (PowerShell)

Problem: Beim Ausführen des Installers erscheint diese Fehlermeldung — PowerShell blockiert Skripte standardmäßig.

Lösung:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Drücke Enter, dann Y, dann Enter.

Danach den Installer-Befehl nochmal ausführen — diesmal ohne Fehler.

Fehler 8: "Skills installation dauert 2+ Stunden"

Das ist auf Windows NORMAL! (noch länger als Mac)

Lösung: Warten oder mit Strg + C abbrechen und skip.

Nützliche Terminal-Befehle

Gateway \& Status

openclaw dashboard              # Dashboard im Browser öffnen
openclaw gateway status         # Ist OpenClaw gestartet?
openclaw gateway restart        # Neu starten (löst die meisten Probleme)
openclaw gateway stop           # Stoppen
openclaw gateway start          # Starten
openclaw gateway run            # Im Vordergrund starten (mit Live-Logs)
openclaw status                 # Channel-Status und letzte Sessions anzeigen
openclaw health                 # Gateway-Gesundheit abrufen
openclaw --help                 # Alle verfügbaren Befehle

Diagnose \& Fehlersuche

openclaw doctor                 # Gesundheitscheck — prüft alles und zeigt Probleme
openclaw doctor --repair        # Wie doctor, versucht Probleme automatisch zu beheben
openclaw logs --follow          # Live-Logs anschauen (Strg+C zum Stoppen)
openclaw logs --follow --json   # Logs im JSON-Format (für Entwickler)
openclaw tui                    # Terminal-UI — Chat direkt im Terminal

Exec Approvals (Tool-Berechtigungen)

openclaw approvals get                               # Aktuelle Berechtigungen anzeigen
openclaw approvals allowlist add "/bin/bash"         # Bash freigeben
openclaw approvals allowlist add "/usr/bin/python3"  # Python freigeben

Hinweis: Wenn dein Assistent keine Terminal-Befehle ausführen kann, liegt es meist an fehlenden Exec Approvals. Starte mit openclaw approvals get und openclaw doctor.

Channels (WhatsApp, Telegram, Discord)

openclaw channels status        # Verbindungsstatus aller Channels
openclaw channels logs          # Channel-Logs anzeigen
openclaw configure              # Channels neu einrichten oder verbinden

Sessions \& Agents

openclaw sessions list          # Gespeicherte Sessions anzeigen
openclaw agents list            # Alle konfigurierten Agenten anzeigen

Skills \& Updates

openclaw skills list            # Installierte Skills anzeigen
openclaw skills search <name>   # Neuen Skill suchen
openclaw update                 # OpenClaw aktualisieren

Sicherheit \& Backup

openclaw security audit         # Sicherheits-Audit durchführen
openclaw backup create          # Backup erstellen
openclaw backup verify          # Backup prüfen

Nützliches für Fortgeschrittene

openclaw memory search <query>  # In Memory-Dateien suchen
openclaw models list            # Verfügbare KI-Modelle anzeigen
openclaw message send --target +43... --message "Test"  # Nachricht senden
openclaw docs                   # Dokumentation durchsuchen

Glückwunsch!

Du hast jetzt einen KI-Assistenten auf Windows!

• Läuft stabil in WSL2 (Linux auf Windows)
• Im Browser: http://127.0.0.1:18789/
• Optional WhatsApp/Telegram
• Auto-Updates