OpenClaw DACH
Alle Guides

OpenClaw auf deinem Windows-PC einrichten

Anfänger20-25 Minuten

Zielgruppe: Du hast noch nie PowerShell benutzt? Keine Sorge — wir machen das Schritt für Schritt.

Dauer: 20-25 Minuten

Schwierigkeit: Anfänger (keine Programmier-Kenntnisse nötig)

Wichtig: Windows 11 empfohlen (Windows 10 auch okay, aber Windows 7 wird nicht unterstützt)

Wichtig: WSL2 vs Native Windows

OpenClaw läuft am besten auf WSL2 (Windows Subsystem for Linux). Das ist eine Linux-Umgebung auf Windows.

Einfache Sprache:

  • WSL2 = Linux läuft INNERHALB von Windows
  • Das ist stabiler und einfacher für Anfänger
  • Native Windows geht auch, aber braucht mehr Setup

Empfehlung: Nutze WSL2 (wir installieren das in Schritt 0)

Schritt 0: Vorbereitung (WSL2 + Node.js)

Schritt 0.1: Node.js auf Windows prüfen

Lass mich überprüfen, ob Node.js bereits installiert ist.

So öffnest du PowerShell:

  1. Drücke Windows-Taste + X auf deiner Tastatur

- Ein Menü öffnet sich unten links

  1. Klick auf "PowerShell (Administrator)" oder "Terminal (Administrator)"

- Falls nicht sichtbar: Drücke Fenster-Taste + S, tippe "PowerShell" ein

  1. Es öffnet sich ein schwarzes/blaues Fenster — das ist PowerShell

Wie sieht PowerShell aus?

PS C:\Users\MaxMustermann>

Schritt 0.2: Node.js Version prüfen

Im PowerShell-Fenster, tippe:

node --version

Drücke Enter.

Was passiert jetzt?

SZENARIO A: Node.js IST installiert

Du siehst eine Versionsnummer wie:

v22.11.0

oder

v20.10.0

Super! Node.js läuft auf deinem Windows.

ABER: Bevor wir weitermachen, installieren wir WSL2 (macht OpenClaw stabiler).

Fahre mit Schritt 0.3 fort.

SZENARIO B: Node.js ist NICHT installiert

Du siehst einen Fehler wie:

'node' is not recognized as an internal or external command

Das ist normal! Wir installieren jetzt alles zusammen mit WSL2.

Fahre mit Schritt 0.3 fort.

Schritt 0.3: WSL2 installieren (sehr wichtig!)

WSL2 ist Linux auf Windows. Das macht OpenClaw viel stabiler.

So installierst du WSL2:

Im PowerShell-Fenster (Administrator), tippe:

wsl --install

Drücke Enter.

Was passiert:

  1. Windows lädt Ubuntu (eine Linux-Version) herunter
  2. Das dauert 5-15 Minuten (abhängig von Internet)
  3. Am Ende siehst du:

```

Installation successful!

```

  1. Wichtig: Windows fragt dich jetzt eventuell, den PC neu zu starten

- Klick auf "Restart now" (Jetzt neu starten)

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

- Dort wirst du aufgefordert, einen Benutzernamen und Passwort zu wählen

- Tippe einen Namen ein (z.B. dein Vorname) und drücke Enter

- Tippe ein Passwort ein (wird nicht angezeigt — das ist normal)

- Bestätige mit Enter

Herzlichen Glückwunsch! WSL2 ist jetzt installiert.

Schritt 0.4: Node.js in WSL2 installieren

Jetzt installieren wir Node.js INNERHALB von WSL2.

Die Ubuntu-Fenster sollte noch offen sein. Falls nicht:

  1. Drücke Windows-Taste + X
  2. Klick auf "Terminal (Administrator)"
  3. Es öffnet sich ein Fenster mit ubuntu Tab

Im Ubuntu-Fenster (nicht PowerShell!), tippe:

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

Drücke Enter.

Danach:

sudo apt-get install -y nodejs

Drücke Enter.

Was passiert:

Das Skript lädt Node.js herunter und installiert es. Das dauert 3-5 Minuten.

Du siehst viel Text, das ist normal.

Am Ende siehst du:

Processing triggers for...

Schritt 0.5: Node.js Version prüfen

Im Ubuntu-Fenster, tippe:

node --version

Drücke Enter.

Du solltest sehen:

v22.11.0

oder eine ähnliche Nummer.

Perfekt! Node.js läuft jetzt in WSL2.

Schritt 1: OpenClaw installieren

Jetzt geht's los!

Wichtig: Bleib im Ubuntu-Fenster (nicht PowerShell). Das Ubuntu-Fenster ist dein Linux-Terminal innerhalb Windows.

Im Ubuntu-Fenster, kopiere diesen Befehl:

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

So machst du es:

  1. Markiere den Befehl mit der Maus (oben im Grau)
  2. Drücke Strg + C um zu kopieren
  3. Klick ins Ubuntu-Fenster
  4. Drücke Strg + V um einzufügen (oder Rechtsklick → Paste)
  5. Drücke Enter

Was passiert:

Der Computer lädt OpenClaw herunter und installiert es. Das dauert 3-5 Minuten.

Du siehst Zeile für Zeile Text. Das ist normal.

Am Ende solltest du sehen:

Installation complete!

oder

OpenClaw v1.5.2 installed successfully

Super! OpenClaw ist installiert.

Schritt 2: OpenClaw einrichten (Onboard)

Der nächste Schritt führt dich durch einen "Assistenten" — eine Art Frage-Antwort Dialog.

Im Ubuntu-Fenster, tippe:

openclaw onboard --install-daemon

Drücke Enter.

Was passiert jetzt:

Der Assistent stellt dir Fragen. Du antwortest mit Pfeiltasten (auf/ab) und Enter.

Frage 1: Welcher KI-Anbieter?

Du siehst Optionen wie:

Welcher KI-Anbieter möchtest du nutzen?

  > Anthropic (Claude)
    OpenAI (ChatGPT)
    Google (Gemini)
    OpenRouter

Wie wählst du?

  1. Drücke die Pfeiltaste nach oben oder unten um eine Option zu markieren
  2. Die markierte Option ist dann grün oder mit > gekennzeichnet
  3. Drücke Enter um die Option zu wählen

Empfehlung für Anfänger:

Wenn du kein Abo hast, wähle Google (Gemini) — das ist kostenlos.

Wenn du Claude-Abo hast, wähle Anthropic (Claude).

Frage 2: API-Key eingeben

Je nachdem was du gewählt hast, fragt der Assistent nach deinem API-Key.

Was ist ein API-Key?

Das ist ein Passwort/Code, das dem Assistenten erlaubt, Claude oder ChatGPT zu nutzen.

Wo bekommst du den Key?

Für Anthropic (Claude):

  1. Öffne in Windows einen Browser
  2. Geh auf https://console.anthropic.com
  3. Melde dich an (oder registriere dich)
  4. Klick auf "API Keys" links
  5. Klick auf "Create Key"
  6. Kopiere den langen Code
  7. Klick ins Ubuntu-Fenster
  8. Drücke Strg + V um einzufügen
  9. Drücke Enter

Für OpenAI (ChatGPT):

  1. Öffne Browser
  2. Geh auf https://platform.openai.com/account/api-keys
  3. Melde dich an
  4. Klick auf "Create new secret key"
  5. Kopiere den Code
  6. Füg ihn im Ubuntu-Fenster ein (Strg + V)
  7. Drücke Enter

Für Google (Gemini) — kostenlos:

  1. Der Assistent führt dich durch OAuth
  2. Browser öffnet sich in Windows
  3. Du meldest dich an (wie bei Gmail)
  4. Du gibst OpenClaw Erlaubnis
  5. Fertig — kein API-Key nötig

Frage 3: Berechtigungen für Windows

Der Assistent könnte fragen: "Darf OpenClaw das tun?"

Es fragt nach verschiedenen Dingen:

  • Automation -- Ja, erlaube das
  • Benachrichtigungen -- Ja, erlaube das
  • Weitere (optional) -- Je nach Bedarf

In den meisten Fällen: Einfach Fragen mit ja oder y beantworten und Enter drücken.

Frage 4: Messaging-Kanäle (WhatsApp, Telegram, etc.)

Der Assistent fragt: "Welche Chat-Apps willst du nutzen?"

Du siehst Optionen wie:

Messaging-Kanäle:

  [x] WhatsApp
  [x] Telegram
  [ ] Discord
  [ ] iMessage
  [ ] Signal

Empfehlung für Anfänger:

Starten wir mit WhatsApp — das ist am einfachsten.

Drücke Pfeiltaste, um WhatsApp zu markieren, und drücke Leertaste um es einzuschalten (oder auszuschalten).

Frage 5: Gateway starten?

Der Assistent fragt: "Gateway als Daemon starten?" oder "Install as service?"

Antwort: JA

Markiere Ja oder Yes und drücke Enter.

Installation fertig!

Du siehst am Ende:

OpenClaw Gateway installed successfully!
Daemon configured
Ready to go!

Perfekt!

Schritt 3: Dashboard öffnen

Das Dashboard ist das "Kontrollzentrum" von OpenClaw. Du siehst es im Browser.

Im Ubuntu-Fenster, tippe:

openclaw dashboard

Drücke Enter.

Was passiert:

  1. Dein Browser öffnet sich automatisch in Windows
  2. Du siehst eine URL wie: http://localhost:18789
  3. Die OpenClaw-Interface lädt
  4. Du siehst ein Chat-Fenster — das ist dein Kontrollzentrum!

Falls Browser sich NICHT öffnet:

Öffne deinen Browser manuell (Chrome, Edge, Firefox) und geh auf:

http://localhost:18789

Schritt 4: Erste Test-Nachricht

Jetzt testen wir, ob alles funktioniert!

  1. Klick ins Chat-Fenster auf der Seite
  2. Tippe: "Hallo! Wer bist du?"
  3. Drücke Enter

OpenClaw sollte dir antworten mit etwas wie:

Hallo! Ich bin OpenClaw, dein persönlicher KI-Assistent...

Wenn das funktioniert: Herzlichen Glückwunsch! OpenClaw läuft!

Schritt 5: WhatsApp verbinden (Optional)

Du kannst OpenClaw auch per WhatsApp steuern — sehr praktisch!

So funktioniert's:

Im Ubuntu-Fenster, tippe:

openclaw channels login --channel whatsapp

Drücke Enter.

Was passiert:

Im Ubuntu-Fenster erscheint ein QR-Code (ein Quadrat mit kleinen Kästchen).

QR-Code mit Handy scannen:

  1. Öffne WhatsApp auf deinem Handy
  2. Geh zu Einstellungen (unten rechts, drei Punkte)
  3. Klick auf "Verknüpfte Geräte"
  4. Klick auf "Gerät hinzufügen"
  5. Öffne die Kamera-App auf deinem Handy
  6. Halte die Kamera über den QR-Code im Ubuntu-Fenster
  7. WhatsApp öffnet sich automatisch und verknüpft
  8. Fertig!

Test-Nachricht via WhatsApp:

Jetzt schreib eine Nachricht an dich selbst in WhatsApp.

Schreib: "Was kannst du tun?"

OpenClaw sollte antworten!

Häufige Fehler und Lösungen (Windows)

Fehler 1: "WSL installation failed" oder "WSL not found"

Problem: WSL2-Installation schlägt fehl

Lösungen:

  1. Virtualisierung aktivieren:

- Drücke Windows-Taste + X

- Klick auf "Systemeinstellungen"

- Geh zu "Apps" → "Apps & Features" → "Optionale Features"

- Klick auf "Weitere Features"

- Suche "Windows-Subsystem für Linux"

- Haken setzen und "OK" klicken

- PC neu starten

  1. BIOS-Einstellungen (Advanced):

- Das ist zu technisch für Anfänger — kontaktiere support@markusstoeger.com

Fehler 2: "Ubuntu window won't open"

Problem: Nach wsl --install öffnet sich kein Ubuntu-Fenster

Lösung:

  1. Drücke Windows-Taste + X
  2. Klick auf "Terminal (Administrator)"
  3. Tab-Reiter sollte "ubuntu" zeigen (nicht PowerShell)
  4. Falls nicht: Klick auf "+" und wähle "Ubuntu"
  5. Fertig!

Fehler 3: "bash: curl: command not found"

Problem: Der Install-Befehl funktioniert nicht

Lösung:

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

Dann versuche die Installation nochmal.

Fehler 4: "command not found: openclaw"

Problem: Nach Installation: openclaw onboard funktioniert nicht

Lösung:

  1. Schließ das Ubuntu-Fenster komplett (Klick auf X)
  2. Öffne es erneut (Windows-Taste + X → Terminal → Ubuntu Tab)
  3. Versuche nochmal

Fehler 5: "Permission denied" oder "cannot execute binary"

Problem: Ubuntu sagt, du darfst das Skript nicht ausführen

Lösung:

chmod +x ~/.openclaw/bin/openclaw

Dann:

openclaw onboard --install-daemon

Fehler 6: "QR-Code erscheint nicht für WhatsApp"

Problem: openclaw channels login --channel whatsapp zeigt nichts

Lösung:

  1. Prüfe ob Gateway läuft:

```bash

openclaw gateway status

```

  1. Du solltest sehen:

```

Gateway is running on port 18789

```

  1. Falls nicht, starte es:

```bash

openclaw gateway restart

```

  1. Warte 5 Sekunden
  2. Versuche WhatsApp-Login nochmal

Fehler 7: "Browser öffnet sich nicht / localhost:18789 funktioniert nicht"

Problem: openclaw dashboard funktioniert nicht

Lösung:

  1. Im Ubuntu-Fenster manuell starten:

```bash

openclaw gateway restart

```

  1. Warte 10 Sekunden
  2. Öffne deinen Browser (Chrome, Edge, Firefox)
  3. Gib manuell ein: http://localhost:18789
  4. Falls immer noch nicht: WSL2-Netzwerk zurücksetzen:

```bash

wsl --shutdown

```

  1. Ubuntu-Fenster neu öffnen und erneut versuchen

Fehler 8: "KI antwortet nicht / Timeout"

Problem: Du schreibst eine Nachricht → Lange Pause → Kein Antwort

Lösungen:

  1. API-Key überprüfen:

```bash

openclaw models list

```

  1. Internet-Verbindung testen:

```bash

ping google.com

```

  1. Gateway neu starten:

```bash

openclaw gateway restart

```

  1. Falls immer noch nicht: Kontaktiere support@markusstoeger.com

Nützliche Ubuntu/Linux-Befehle

Falls du später was brauchst:

Dashboard öffnen

openclaw dashboard

Öffnet im Browser

Status prüfen

openclaw gateway status

Zeigt ob OpenClaw läuft

Neu starten

openclaw gateway restart

Startet OpenClaw neu

Stoppen

openclaw gateway stop

Schaltet aus

Kanäle überprüfen

openclaw channels status

Zeigt verbundene Apps

Modelle anzeigen

openclaw models list

Zeigt konfigurierte KI-Modelle

Selbst-Diagnose

openclaw doctor

Prüft automatisch auf Probleme

Manueller Gateway-Start (falls nötig)

openclaw gateway --port 18789 --verbose

Startet mit Logging

Alles funktioniert?

Glückwunsch! Du hast OpenClaw auf Windows erfolgreich installiert!

Nächste Schritte:

  1. Erkunde das Dashboard — schau dich um
  2. Verbinde mehr Kanäle — Telegram, Discord, etc. (optional)
  3. Installiere Skills — Erweiterungen (optional)
  4. Testen und nutzen — dein neuer KI-Assistent!

Immer noch Probleme?

Option 1: Selbst-Hilfe

  • Siehe "Häufige Fehler" oben
  • Schließ Ubuntu-Fenster und öffne erneut
  • Starte deinen PC neu (hilft oft!)

Option 2: Support

  • E-Mail: support@markusstoeger.com
  • Beschreib das Problem
  • Kopier die Fehler-Nachricht

Option 3: Managed Hosting

  • Keine Lust auf Terminal?
  • Wir richten alles ein
  • 19 Euro/Monat, 7 Tage kostenlos
  • Mehr Infos auf openclaw.markusstoeger.com

Zu kompliziert? Wir machen das für dich.

Managed Hosting: In 60 Sekunden fertig. 7 Tage kostenlos.

7 Tage kostenlos testen