openclaw-native

openclaw-native-windows-install

Hallo zusammen! Gestern haben wir unsere WSL2-Installationsanleitung veröffentlicht und viel Feedback bekommen. Einige haben gefragt: „Kann man OpenClaw auch nativ unter Windows installieren? Ohne WSL2?"

Die Antwort lautet: Ja, aber es gibt Hürden.

In diesem Beitrag zeige ich Schritt für Schritt, wie man OpenClaw nativ unter Windows installiert – samt aller Stolperfallen und ihrer Lösungen. Das hier ist das Ergebnis von über 30 Installationstests.

⚠️ Wichtiger Hinweis: Offizielle Haltung vs. tatsächliche Machbarkeit

Offizielle Dokumentation: - OpenClaw empfiehlt offiziell die Nutzung von WSL2 - Die native Windows-Installation ist nicht offiziell dokumentiert - Community-Berichten liegt die Erfolgsquote bei ca. 60–70 %

Realität: - OpenClaw läuft tatsächlich unter nativem Windows - Man benötigt eine vollständige C++-Compiler-Umgebung - Geeignet für Nutzer mit Windows-Entwicklungserfahrung - Manche Funktionen (z. B. WhatsApp-Kanal) können Kompatibilitätsprobleme haben

Diese Anleitung ist geeignet für: - ✅ Nutzer mit Windows-Entwicklungserfahrung, vertraut mit PowerShell - ✅ Nutzer, die direkten Zugriff auf das Windows-Dateisystem brauchen - ✅ Nutzer, die WSL2-Virtualisierung vermeiden wollen - ✅ Nutzer, die bereit sind, potenzielle Probleme selbst zu troubleshooten

Nicht empfohlen für: - ❌ Windows-Anfänger - ❌ Nutzer, die WhatsApp/Telegram-Kanäle brauchen (WSL2 ist stabiler) - ❌ Alle, die die einfachstmögliche Installation suchen - ❌ Produktionsumgebungen

Systemanforderungen

Komponente Mindestanforderung Empfohlen
Betriebssystem Windows 10 1903+ Windows 11 22H2+
Node.js 22.0.0+ Neuestes 22.x LTS
Arbeitsspeicher 4 GB 8 GB+
Festplattenspeicher 5 GB 10 GB+
Berechtigungen Administratorrechte Administratorrechte
Netzwerk Stabile Internetverbindung Zugriff auf GitHub/npm

Kompletter Installationsablauf

Phase 1: Vorbereitung (entscheidend!)

Der Hauptgrund für gescheiterte Installationen unter nativem Windows: unvollständige Abhängigkeiten. Bitte haltet euch exakt an die Reihenfolge.

1.1 Node.js 22+ installieren

Schritte:

  1. Öffnet die Node.js-Webseite
  2. Ladet die LTS-Version herunter (22.x oder höher)
  3. Führt den Installer aus und behaltet die Standardoptionen bei
  4. Nach der Installation: PowerShell neu starten

Verifikation:

POWERSHELL 
node --version
npm --version

Erwartete Ausgabe:

v22.x.x
10.x.x

⚠️ Häufige Fehler: - Falls die Version unter 22 liegt: deinstallieren und neu installieren - Falls der Befehl nicht gefunden wird: Umgebungsvariable PATH überprüfen

1.2 Git installieren

OpenClaw benötigt Git, um Abhängigkeiten herunterzuladen.

Installation über winget (empfohlen):

POWERSHELL 
winget install Git.Git

Oder manuell: 1. Öffnet Git for Windows 2. Ladet herunter und führt den Installer aus 3. Standardoptionen beibehalten

Verifikation:

POWERSHELL 
git --version

Erwartete Ausgabe:

git version 2.x.x.windows.1

1.3 CMake installieren

node-llama-cpp benötigt CMake.

Über winget:

POWERSHELL 
winget install Kitware.CMake

Verifikation:

POWERSHELL 
cmake --version

Erwartete Ausgabe:

cmake version 3.x.x

1.4 Python installieren (node-gyp-Abhängigkeit)

Einige npm-Pakete benötigen Python zum Kompilieren.

Über winget:

POWERSHELL 
winget install Python.Python.3.11

⚠️ Wichtig: Bei der Installation „Add Python to PATH" anhaken.

Verifikation:

POWERSHELL 
python --version

1.5 Visual Studio Build Tools installieren (am kritischsten!)

Das ist der Punkt, an dem die native Windows-Installation am häufigsten scheitert. node-gyp benötigt eine vollständige C++-Toolchain.

Methode 1: Über winget (empfohlen)

POWERSHELL 
winget install Microsoft.VisualStudio.2022.BuildTools

Methode 2: Manueller Download 1. Öffnet Visual Studio Build Tools 2. Ladet herunter und führt den Installer aus

Pflichtkomponenten nach der Installation:

Öffnet den Visual Studio Installer → Ändern → folgende Komponenten anhaken:

  • ✅ Desktopentwicklung mit C++
  • ✅ MSVC v143 – VS 2022 C++-Buildtools
  • ✅ Windows 10/11 SDK
  • ✅ C++-CMake-Tools für Windows

Verifikation:

POWERSHELL 
# MSVC-Compiler prüfen
cl

# Sollte Compiler-Versionsinformationen ausgeben

⚠️ Falls nicht vollständig installiert: Bei der OpenClaw-Installation erscheint folgender Fehler:

error MSB8020: The build tools for v143 cannot be found.
error: Failed to compile llama.cpp

Phase 2: OpenClaw installieren

2.1 Alte Installation bereinigen (falls vorhanden)

POWERSHELL 
# Alte Version deinstallieren
npm uninstall -g openclaw

# npm-Cache leeren
npm cache clean --force

# Konfigurationsverzeichnis löschen (optional, verliert Konfiguration)
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw -ErrorAction SilentlyContinue

2.2 OpenClaw CLI installieren

Öffnet PowerShell als Administrator und führt aus:

POWERSHELL 
npm install -g openclaw@latest

Die Installation kann 5–15 Minuten dauern, da native Module kompiliert werden müssen.

⚠️ PowerShell-Hinweis:

PowerShell unterstützt die &&-Syntax nicht. Für mehrere Befehle nutzt ;:

POWERSHELL 
# ❌ Falsch (bash-Syntax)
npm cache clean --force && npm install -g openclaw

# ✅ Richtig (PowerShell-Syntax)
npm cache clean --force; npm install -g openclaw

2.3 Installation überprüfen

POWERSHELL 
openclaw --version
openclaw --help

Erwartete Ausgabe:

openclaw/2026.x.x windows-x64 node-v22.x.x

Phase 3: Konfiguration initialisieren

3.1 Konfigurationsassistent starten

POWERSHELL 
openclaw onboard --install-daemon

Konfigurationsschritte:

  1. Gateway-Typ wählen: Local (lokal) oder Remote
  2. AI-Modell wählen: Anthropic / OpenAI / Google usw.
  3. API-Key eingeben: Bereithalten
  4. Kommunikationskanal wählen: Web UI / Telegram / Discord usw.
  5. Daemon installieren: Yes wählen für Autostart

3.2 Windows-Autostart konfigurieren

Der OpenClaw-Daemon benötigt unter Windows den Aufgabenplaner (Task Scheduler).

Manuell eine Aufgabe erstellen:

  1. Öffnet den Aufgabenplaner
  2. Einfache Aufgabe erstellen
  3. Name: OpenClaw Gateway
  4. Trigger: Bei Anmeldung
  5. Aktion: Programm starten
  6. Programm/Skript: C:\Users\DEINBENUTZERNAME\AppData\Roaming\npm\openclaw.cmd
  7. Argumente: gateway start
  8. Erstellen abschließen

Erweiterte Einstellungen: - „Unabhängig von der Benutzeranmeldung ausführen" anhaken - „Mit höchsten Berechtigungen ausführen" anhaken - Unter „Bedingungen" den Haken bei „Task nur starten, wenn Computer mit Wechselstrom betrieben wird" entfernen

3.3 Gateway starten

POWERSHELL 
# Gateway starten
openclaw gateway start

# Status prüfen
openclaw gateway status

# Logs anzeigen
openclaw gateway logs

3.4 Web-Controlpanel aufrufen

Öffnet den Browser und geht zu:

http://127.0.0.1:18789/

Falls ein Token verlangt wird: Dieses wurde im Konfigurationsassistenten generiert.

Häufige Fehler und Lösungen

Fehler 1: Git nicht gefunden

Fehlermeldung:

npm error syscall spawn git
npm error enoent
npm error spawn git ENOENT

Ursache: Git ist nicht installiert oder nicht im PATH

Lösung:

POWERSHELL 
# Git installieren
winget install Git.Git

# PowerShell neu starten und prüfen
git --version

Fehler 2: CMake-Download fehlgeschlagen

Fehlermeldung:

[node-llama-cpp] Failed to download cmake
Error: connect ETIMEDOUT

Ursache: Netzwerkproblem beim CMake-Download

Lösung:

POWERSHELL 
# CMake manuell installieren
winget install Kitware.CMake

# Prüfen
cmake --version

Fehler 3: Visual Studio C++-Toolchain fehlt

Fehlermeldung:

gyp ERR! find VS
gyp ERR! find VS msvs_version not set from command line or npm config
gyp ERR! find VS checking VS2022 not found
gyp ERR! find VS not found: most reliable installation method is missing

Ursache: Visual Studio Build Tools oder C++-Workload nicht installiert

Lösung:

  1. Visual Studio Build Tools installieren: powershell winget install Microsoft.VisualStudio.2022.BuildTools

  2. Visual Studio Installer öffnen

  3. Auf Ändern klicken

  4. Desktopentwicklung mit C++ anhaken

  5. Folgende Komponenten sicherstellen: - MSVC v143 – VS 2022 C++-Buildtools - Windows 10/11 SDK - C++-CMake-Tools für Windows

  6. PowerShell neu starten

  7. OpenClaw neu installieren: powershell npm uninstall -g openclaw npm cache clean --force npm install -g openclaw@latest

Fehler 4: node-gyp-Kompilierung fehlgeschlagen

Fehlermeldung:

gyp ERR! build error
gyp ERR! stack Error: `C:\Program Files\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe` failed with exit code: 1

Ursache: Unvollständige Compiler-Umgebung oder Netzwerkproblem

Lösung:

  1. Sicherstellen, dass alle Abhängigkeiten installiert sind (Git, CMake, VS Build Tools, Python)

  2. npm-Mirror auf chinesischen Spiegel setzen (optional): powershell npm config set registry https://registry.npmmirror.com

  3. Bereinigen und neu installieren: powershell npm uninstall -g openclaw npm cache clean --force npm install -g openclaw@latest --omit=optional

Fehler 5: Berechtigungsfehler

Fehlermeldung:

Error: EACCES: permission denied, mkdir 'C:\Program Files\nodejs\node_modules\openclaw'

Ursache: Globale npm-Installation erfordert Administratorrechte

Lösung:

Methode 1: PowerShell als Administrator ausführen - Rechtsklick auf PowerShell → Als Administrator ausführen

Methode 2: npm-Globalverzeichnis ändern

POWERSHELL 
# Neues globales Verzeichnis erstellen
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.npm-global"

# npm konfigurieren
npm config set prefix "$env:USERPROFILE\.npm-global"

# Dauerhaft zum PATH hinzufügen
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$env:USERPROFILE\.npm-global", "User")

# PowerShell neu starten und prüfen
npm install -g openclaw

Fehler 6: Port bereits belegt

Fehlermeldung:

Error: listen EADDRINUSE: address already in use :::18789

Ursache: Port 18789 ist bereits belegt (möglicherweise doppelter Start)

Lösung:

  1. Prozess finden, der den Port belegt: powershell netstat -ano | findstr :18789

  2. Prozess beenden (PID ersetzen): powershell taskkill /F /PID <PID>

  3. Oder einen anderen Port nutzen: powershell openclaw gateway --port 18790

Fehler 7: Befehl nicht gefunden

Fehlermeldung:

'openclaw' ist kein interner oder externer Befehl.

Ursache: npm-Globalverzeichnis nicht im PATH

Lösung:

  1. npm-Globalverzeichnis ermitteln: powershell npm prefix -g

  2. Zum PATH hinzufügen: ```powershell # Temporär (aktuelle Sitzung) $env:Path += ";" + (npm prefix -g)

# Dauerhaft

```

  1. PowerShell neu starten

Fehler 8: WebSocket-Verbindung fehlgeschlagen (WhatsApp/Telegram)

Fehlermeldung:

WebSocket connection failed
Channel connection timeout

Ursache: Die native Windows-WebSocket-Implementierung ist mit manchen Kanälen inkompatibel

Lösung:

Dringende Empfehlung: Für WhatsApp/Telegram-Kanäle die WSL2-Installation nutzen

Falls natives Windows unvermeidbar ist: 1. Sicherstellen, dass die Firewall Node.js Netzwerkzugriff erlaubt 2. Proxy ausprobieren 3. Wechsel zu stabileren Kanälen wie Discord/Slack in Betracht ziehen

Natives Windows vs. WSL2 im Vergleich

Merkmal Natives Windows WSL2 (Ubuntu)
Installationsschwierigkeit ⭐⭐⭐⭐ Schwierig ⭐⭐ Einfach
Abhängigkeits-Komplexität Hoch (manuell) Niedrig (Paketmanager)
Dateizugriff ✅ Direkt ⚠️ Über /mnt/c
Leistung ⭐⭐⭐⭐ Nativer ⭐⭐⭐ Virtualisierungs-Overhead
Kompatibilität ⚠️ Teilweise Kanalprobleme ✅ Offiziell empfohlen
Wartungsaufwand Hoch Niedrig
Geeignet für Windows-Entwicklung Produktionsumgebung

Wann natives Windows wählen?

✅ Geeignet für native Installation: - Häufiger Zugriff auf Windows-Dateien (Desktop, Dokumente) - Erfahrung mit Windows-Entwicklung - Nur Web UI oder Discord/Slack-Kanäle - Keine Virtualisierung gewünscht

❌ WSL2 empfohlen: - Windows-Anfänger - WhatsApp/Telegram-Kanäle benötigt - Stabilität und Zuverlässigkeit Priorität - Produktionsumgebung

PowerShell-Syntax – häufige Fehler

Nutzer, die von Linux/macOS umsteigen, machen oft folgende Fehler:

POWERSHELL 
# ❌ bash-Syntax (PowerShell nicht unterstützt)
openclaw gateway start && openclaw status

# ✅ PowerShell-Syntax
openclaw gateway start; openclaw status

# Oder in zwei Zeilen
openclaw gateway start
openclaw gateway status
POWERSHELL 
# ❌ bash-Syntax
export OPENCLAW_HOME=C:\openclaw

# ✅ PowerShell-Syntax
$env:OPENCLAW_HOME = "C:\openclaw"
POWERSHELL 
# ❌ bash-Syntax
cat ~/.openclaw/config.json

# ✅ PowerShell-Syntax
Get-Content $env:USERPROFILE\.openclaw\config.json

Leistungsoptimierung

1. Windows Defender-Scan ausschließen

OpenClaw liest und schreibt häufig Dateien – Defender kann das ausbremsen.

Ausnahmen hinzufügen:

POWERSHELL 
# Als Administrator ausführen
Add-MpPreference -ExclusionPath "$env:USERPROFILE\.openclaw"
Add-MpPreference -ExclusionPath "$(npm prefix -g)\node_modules\openclaw"

2. Umgebungsvariablen konfigurieren

POWERSHELL 
# OpenClaw-Verzeichnis setzen
$env:OPENCLAW_HOME = "D:\OpenClaw"
[Environment]::SetEnvironmentVariable("OPENCLAW_HOME", "D:\OpenClaw", "User")

# Status-Verzeichnis setzen
$env:OPENCLAW_STATE_DIR = "D:\OpenClaw\state"
[Environment]::SetEnvironmentVariable("OPENCLAW_STATE_DIR", "D:\OpenClaw\state", "User")

3. Log-Größe begrenzen

Konfigurationsdatei ~/.openclaw\openclaw.json bearbeiten:

JSON 
{
  "logging": {
    "maxSize": "10MB",
    "maxFiles": 3
  }
}

Sicherheitsempfehlungen

1. Netzwerkzugriff einschränken

Erlaubte Verbindungen in der Konfiguration begrenzen:

JSON 
{
  "channels": {
    "webchat": {
      "allowFrom": ["127.0.0.1", "192.168.1.0/24"]
    }
  }
}

2. Authentifizierung aktivieren

JSON 
{
  "auth": {
    "required": true,
    "type": "token",
    "token": "your-secure-token-here"
  }
}

3. Skill-Berechtigungen einschränken

JSON 
{
  "skills": {
    "allowList": ["file.read", "web.search"],
    "denyList": ["exec", "file.delete", "file.write"]
  }
}

4. Regelmäßiges Security-Audit

POWERSHELL 
openclaw security audit --deep

Deinstallationsanleitung

OpenClaw vollständig deinstallieren

POWERSHELL 
# 1. Gateway stoppen
openclaw gateway stop

# 2. CLI deinstallieren
npm uninstall -g openclaw

# 3. Konfigurationsverzeichnis löschen
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

# 4. Aufgabenplaner-Task löschen (falls erstellt)
# Aufgabenplaner öffnen → OpenClaw Gateway-Task löschen

# 5. Umgebungsvariablen bereinigen (falls gesetzt)
# Systemeigenschaften → Erweitert → Umgebungsvariablen → OPENCLAW_* löschen

Zusammenfassung

Checkliste für die native Windows-Installation

Vor der Installation prüfen:

  • [ ] Windows 10 1903+ oder Windows 11
  • [ ] Node.js 22+ installiert
  • [ ] Git installiert und im PATH
  • [ ] CMake installiert
  • [ ] Python 3.11 installiert
  • [ ] Visual Studio Build Tools + C++-Workload installiert
  • [ ] PowerShell mit Administratorrechten

Installationsschritte:

  1. ✅ Alle Abhängigkeiten installieren
  2. ✅ npm install -g openclaw@latest
  3. ✅ openclaw onboard --install-daemon
  4. ✅ Aufgabenplaner konfigurieren
  5. ✅ openclaw gateway start
  6. ✅ http://127.0.0.1:18789/ aufrufen

Letzte Empfehlung

Wenn eure Hauptanforderungen sind:

  • 📱 WhatsApp/Telegram-Kanäle → WSL2 nutzen
  • 🖥️ Nur Web UI → Natives Windows funktioniert
  • 📁 Häufiger Windows-Dateizugriff → Natives Windows besser
  • 🚀 Produktionsumgebung → WSL2 oder Linux-Server
  • 🎯 Lernerfahrung → Beide ausprobieren

Meine persönliche Empfehlung:

Für Windows-Anfänger: einfach WSL2 nehmen. Die gestrige Anleitung beschreibt den WSL2-Installationsprozess detailliert – einfacher, stabiler, besser offiziell unterstützt.

Für Windows-Profis, die gerne tüfteln: Die native Installation gibt euch tieferes Verständnis der zugrundeliegenden Abhängigkeiten.

Egal für welchen Weg ihr euch entscheidet – OpenClaw ist ein mächtiges Tool, das die Investition wert ist.

Weiterführende Ressourcen: - WSL2-Installationsanleitung – Offiziell empfohlene Variante - OpenClaw offizielle Dokumentation - GitHub Discussion #7462 – Windows nativ vs. WSL2 - GitHub Issue #23178 – Diskussion zur nativen Windows-Unterstützung - Node.js Download - Visual Studio Build Tools

Feedback: Falls ihr bei der Installation auf Probleme stoßt, die hier nicht abgedeckt sind, schreibt gerne einen Kommentar. Ich aktualisiere diesen Artikel laufend.

Nächster Beitrag: Wir werden das Skill-System von OpenClaw genauer unter die Lupe nehmen und zeigen, wie ihr die Fähigkeiten eures AI-Assistenten selbst anpassen könnt – damit er euren Workflow wirklich versteht. Bleibt dran!