OpenClaw unter Windows installieren: So geht's richtig

Kennst du das? Du willst ein neues Tool ausprobieren, aber Windows macht dir einen Strich durch die Rechnung. Pfade stimmen nicht, Shell-Kommandos funktionieren unter Windows anders als in der Dokumentation und am Ende verbringst du mehr Zeit mit der Konfiguration deiner Umgebung als mit dem eigentlichen Projekt.

Die Installation von OpenClaw auf Windows ist eigentlich unkompliziert – solange du die spezifischen Eigenheiten des Systems kennst. Ich habe sowohl die native PowerShell-Methode als auch den Weg über WSL2 getestet. Mein Rat: WSL2 ist der einzige offiziell stabile Pfad. PowerShell eignet sich für schnelle Tests, hat aber klare Grenzen.

Voraussetzungen

Bevor du startest, stelle sicher, dass du folgende Voraussetzungen erfüllst:

• Windows 10 (Version 1903+) oder Windows 11
• PowerShell 5.1 oder neuer (auf modernen Windows-Systemen vorinstalliert)
• Ein API Key von Anthropic, OpenAI oder Google – alternativ kannst du Ollama für kostenlose lokale Modelle nutzen

Falls Node.js nicht installiert ist, kümmert sich der Installer für dich darum.

Quick Start (Methode 1: PowerShell)

Diese Methode ist schnell, aber eingeschränkt. Die native Installation via PowerShell ist vom offiziellen Team nicht getestet und kann Kompatibilitätsprobleme mit verschiedenen Tools verursachen. Für den produktiven Einsatz solltest du WSL2 bevorzugen.

Öffne die PowerShell als Administrator und führe diesen Befehl aus:

iwr -useb https://openclaw.ai/install.ps1 | iex

Was dieser Befehl macht

1. ✅ Prüft auf Node.js 22+ (installiert es via winget/Chocolatey/Scoop, falls es fehlt)
2. ✅ Führt npm install -g openclaw@latest aus
3. ✅ Startet den Setup Wizard

Installations-Optionen

Der PowerShell-Installer unterstützt verschiedene Parameter:

# Standard: npm install (empfohlen)
iwr -useb https://openclaw.ai/install.ps1 | iex

# Alternative: Installation aus dem GitHub-Source
iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git

# Mit benutzerdefiniertem Verzeichnis für die Git-Installation
iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git -GitDir "C:\openclaw"

Methode 2: WSL2 (Empfohlen)

Wenn du OpenClaw intensiv nutzen willst oder Wert auf maximale Stabilität legst, ist WSL2 die richtige Wahl. Damit erhältst du eine vollständige Linux-Umgebung innerhalb von Windows.

Schritt 1: WSL2 installieren

Öffne die PowerShell als Administrator:

wsl --install

Starte deinen Computer neu, wenn du dazu aufgefordert wirst.

Schritt 2: systemd aktivieren (Erforderlich)

Nach dem Neustart öffnest du Ubuntu und führst folgende Befehle aus:

# systemd für das OpenClaw Gateway aktivieren
sudo nano /etc/wsl.conf

Füge diese Zeilen hinzu:

[boot]
systemd=true

Speichern (Strg+O, Enter, Strg+X) und WSL neu starten:

# In der PowerShell
wsl --shutdown
wsl

Schritt 3: OpenClaw in WSL installieren

Führe in deinem Ubuntu-Terminal diesen Befehl aus:

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

Damit läuft OpenClaw in einer sauberen Linux-Umgebung.

Nach der Installation: Setup Wizard

Nach der Installation startet der Setup Wizard automatisch. Du konfigurierst dort:

1. AI Model Provider

Provider	Notizen
Anthropic (Claude)	Beste Ergebnisse, benötigt API Key
OpenAI	Sehr gut für Coding
Google Gemini	Kostenlose Stufe verfügbar
Ollama	100 % kostenlos, läuft lokal

2. Chat Channel

Wähle aus, wie du mit OpenClaw kommunizieren möchtest:

• WhatsApp, Telegram, Discord oder iMessage

3. Gateway Daemon

Wähle bei der Abfrage die Installation als Daemon:

openclaw onboard --install-daemon

Dadurch läuft OpenClaw dauerhaft im Hintergrund.

Installation überprüfen

Nutze diese Befehle, um sicherzustellen, dass alles funktioniert:

# Version prüfen
openclaw --version

# Diagnose ausführen
openclaw doctor

# Dashboard öffnen
openclaw dashboard

Fehlerbehebung

”openclaw is not recognized”

Dein globaler npm-Ordner befindet sich nicht im PATH.

Lösung:

# Finde deinen npm-Präfix
npm config get prefix

# Füge das Ergebnis + \bin zu deinem PATH hinzu
# Meistens: %AppData%\npm

Starte die PowerShell danach neu.

”spawn git ENOENT” Fehler

Für Installationen aus der Quelle wird Git for Windows benötigt.

Lösung:

1. Lade Git von git-scm.com/download/win herunter
2. Installiere es mit den Standardeinstellungen
3. Starte die PowerShell neu und versuche es erneut

Node.js Versionsprobleme

Falls du eine veraltete Node.js-Version hast:

# Mit winget
winget install OpenJS.NodeJS.LTS

# Mit Chocolatey
choco install nodejs-lts

# Mit Scoop
scoop install nodejs-lts

Windows Defender blockiert die Installation

Füge einen Ausschluss für das OpenClaw-Verzeichnis hinzu:

1. Öffne Windows-Sicherheit → Viren- & Bedrohungsschutz
2. Klicke auf “Einstellungen verwalten”
3. Gehe zu “Ausschlüsse” → Ausschlüsse hinzufügen oder entfernen
4. Ordner hinzufügen: %AppData%\npm\node_modules\openclaw

Du kommst nicht weiter? Unser AI Setup Assistant kennt die gesamte OpenClaw-Dokumentation und hilft dir in Echtzeit bei spezifischen Windows-Problemen.

PowerShell vs. WSL2: Was solltest du wählen?

Aspekt	PowerShell	WSL2
Setup-Zeit	2 Minuten	10 Minuten
Stabilität	Gut	Exzellent
Shell Tools	Eingeschränkt	Volles Linux
Updates	Einfach	Einfach

Meine Empfehlung: Starte mit der PowerShell. Wenn du auf Probleme stößt oder mehr Kontrolle brauchst, wechsle zu WSL2.

Nächste Schritte

• Allgemeiner Installations-Guide → — Alle Plattformen im Überblick
• Telegram verbinden → — Steuerung über dein Smartphone
• Docker Deployment → — Isolierte Container-Umgebung
• Lokale AI nutzen → — Null API-Kosten