openclaw-windows

openclaw-windows-install

Hallo zusammen! Heute geht es darum, wie man OpenClaw auf einem Windows-System installiert – den quelloffenen persönlichen KI-Assistenten, der direkt auf deinem eigenen Rechner läuft.

Wenn du es leid bist, deine Daten an Cloud-KI-Dienste zu schicken, und stattdessen einen vollständig kontrollierbaren Assistenten möchtest, der auf lokale Dateien zugreifen und echte Aufgaben erledigen kann, dann ist OpenClaw genau das Richtige für dich.

Was ist OpenClaw?

OpenClaw ist ein selbst gehostetes KI-Gateway, das folgendes kann:

  • 📱 Verbindung zu mehreren Chat-Plattformen (WhatsApp, Telegram, Discord, WeChat usw.)
  • 🤖 Anbindung an verschiedene KI-Modelle (OpenAI, Claude, Gemini, lokale Modelle usw.)
  • 📁 Zugriff auf dein lokales Dateisystem und APIs
  • ⚙️ Echte Aufgaben ausführen, nicht nur chatten
  • 🔒 Komplett auf deinem eigenen Rechner laufen – Daten verlassen ihn nicht

Die wichtigsten Vorteile: - Selbst gehostet – läuft auf deiner Hardware, du hast die Kontrolle - Multi-Channel – ein Gateway für mehrere Chat-Apps gleichzeitig - Open Source – MIT-Lizenz, Community-getrieben - Niedrige Einstiegshürde – Node.js 22+, in 5 Minuten installiert

Systemanforderungen

Bevor du loslegst, prüfe bitte, ob dein System folgende Anforderungen erfüllt:

Komponente Anforderung Hinweis
Betriebssystem Windows 10/11 Windows 11 empfohlen
Node.js 22 oder höher Pflicht! Ältere Versionen scheitern
RAM Mindestens 4GB 8GB+ empfohlen
Festplattenspeicher 2GB frei Für Installation und Cache
Netzwerk Stabile Internetverbindung Für Abhängigkeiten und API-Aufrufe

⚠️ Wichtiger Hinweis

Windows-Nutzer müssen WSL2 verwenden!

Der offizielle Weg für OpenClaw unter Windows ist WSL2 (Windows Subsystem for Linux 2). Theoretisch funktioniert es auch nativ unter Windows, aber dabei tauchen allerlei Kompatibilitätsprobleme auf. Diese Anleitung beschreibt den WSL2-Ansatz im Detail.

Schritt 1: WSL2 installieren

Methode 1: Ein-Klick-Installation (empfohlen)

Öffne PowerShell oder die Eingabeaufforderung als Administrator und führe folgenden Befehl aus:

POWERSHELL 
wsl --install

Dieser Befehl: 1. Aktiviert die WSL-Funktion 2. Aktiviert die virtuelle Maschinenplattform 3. Installiert Ubuntu als Standard-Distribution 4. Fordert einen Neustart des Computers

Nach dem Neustart öffnet sich Ubuntu automatisch und fordert dich auf, einen Benutzernamen und ein Passwort zu vergeben.

Methode 2: Manuelle Installation

Wenn die Ein-Klick-Installation fehlschlägt, kannst du es manuell versuchen:

POWERSHELL 
# 1. WSL-Funktion aktivieren
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 2. Virtuelle Maschinenplattform aktivieren
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 3. Computer neu starten
shutdown /r /t 0

# 4. Nach dem Neustart WSL2 als Standard setzen
wsl --set-default-version 2

# 5. Ubuntu aus dem Microsoft Store installieren
# Oder ausführen:
wsl --install -d Ubuntu

WSL2-Installation überprüfen

POWERSHELL 
# WSL-Version prüfen
wsl --version

# Installierte Distributionen auflisten
wsl --list --verbose

# Sicherstellen, dass Ubuntu WSL2 nutzt
wsl --set-version Ubuntu 2

Erwartete Ausgabe:

  NAME      STATE           VERSION
* Ubuntu    Running         2

Schritt 2: Node.js 22 in WSL2 installieren

OpenClaw benötigt Node.js 22 oder höher. Das ist der häufigste Grund für fehlgeschlagene Installationen!

Methode 1: Über NodeSource (empfohlen)

Führe im Ubuntu-Terminal folgende Befehle aus:

BASH 
# 1. Paketliste aktualisieren
sudo apt update

# 2. curl installieren (falls noch nicht geschehen)
sudo apt install -y curl

# 3. NodeSource-Setup-Skript herunterladen und ausführen
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 4. Node.js installieren
sudo apt install -y nodejs

# 5. Installation überprüfen
node --version
npm --version

Erwartete Ausgabe:

v22.x.x
10.x.x

Methode 2: Über nvm (Node Version Manager)

Wenn du mehrere Node.js-Versionen verwalten musst:

BASH 
# 1. nvm installieren
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 2. Shell-Konfiguration neu laden
source ~/.bashrc

# 3. Node.js 22 installieren
nvm install 22

# 4. Als Standard-Version setzen
nvm use 22
nvm alias default 22

# 5. Überprüfen
node --version

⚠️ Häufige Fehler beheben

Fehler 1: node: command not found

BASH 
# npm-Globalpfad prüfen
npm prefix -g

# Zu PATH hinzufügen (in ~/.bashrc eintragen)
export PATH="$(npm prefix -g)/bin:$PATH"
source ~/.bashrc

Fehler 2: Berechtigungsprobleme

BASH 
# npm-Berechtigungen reparieren
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Schritt 3: OpenClaw installieren

Methode 1: Offizielles Installationsskript (empfohlen)

Führe im Ubuntu-Terminal folgenden Befehl aus:

BASH 
# Ein-Klick-Installation
curl -fsSL https://openclaw.sh/install | bash

Der Installationsvorgang: 1. Lädt die OpenClaw CLI herunter 2. Installiert sie global via npm 3. Erstellt das Konfigurationsverzeichnis ~/.openclaw 4. Startet den interaktiven Einrichtungsassistenten

Methode 2: Manuelle Installation über npm

BASH 
# OpenClaw global installieren
npm install -g openclaw

# Installation überprüfen
openclaw --version

Überprüfung nach der Installation

BASH 
# System-Healthcheck
openclaw doctor

# Status anzeigen
openclaw status

# Web-Dashboard öffnen
openclaw dashboard

Schritt 4: Initiale Konfiguration abschließen

Nach der Installation startet OpenClaw automatisch den interaktiven Einrichtungsassistenten. Falls nicht, kannst du ihn manuell aufrufen:

BASH 
openclaw onboard --install-daemon

Konfigurationsschritte im Detail

1. KI-Modell-Anbieter auswählen

OpenClaw unterstützt verschiedene KI-Modelle:

  • OpenAI (GPT-4, GPT-3.5)
  • Anthropic (Claude 3/3.5)
  • Google (Gemini Pro/Flash)
  • Lokale Modelle (über LM Studio, Ollama usw.)

Empfohlene Konfiguration: - Für beste Qualität → Claude 3.5 Sonnet - Für beste Preis-Leistung → Gemini 2.0 Flash - Für maximale Privatsphäre → Lokales Qwen/Llama-Modell

Gib im Assistenten deinen API-Key ein.

2. Kommunikationskanäle konfigurieren

Du kannst wählen, wie du mit OpenClaw interagieren möchtest:

  • Web-UI – Über den Browser (standardmäßig aktiviert)
  • Telegram – Benötigt Bot-Token
  • WhatsApp – Erfordert QR-Code-Scan
  • Discord – Benötigt Bot-Token
  • Überspringen – Später konfigurierbar

Tipp für Einsteiger: Nutze zuerst die Web-UI und konfiguriere später weitere Kanäle.

3. Skills aktivieren

Das Skills-System von OpenClaw ermöglicht verschiedene Aufgaben:

  • ✅ Dateioperationen – Dateien lesen/schreiben, Inhalte durchsuchen
  • ✅ Websuche – Echtzeit-Informationen aus dem Netz
  • ✅ Code-Ausführung – Python/Shell-Skripte ausführen
  • ✅ Zeitgesteuerte Aufgaben – Erinnerungen und Automatisierung
  • ✅ Multimodal – Bilder und Dokumente verarbeiten

Empfehlung: Alle aktivieren – Berechtigungen lassen sich später in der Konfigurationsdatei einschränken.

4. Daemon installieren

Damit OpenClaw dauerhaft läuft, empfiehlt sich die Installation als Systemdienst:

BASH 
# Im Einrichtungsassistenten "Install Daemon" wählen
# Oder manuell ausführen:
openclaw gateway install
openclaw gateway start

Schritt 5: OpenClaw nutzen

Web-Dashboard aufrufen

BASH 
openclaw dashboard

Dies öffnet http://127.0.0.1:18789/ in deinem Browser.

Hauptfunktionen: - 💬 Mit dem KI-Assistenten chatten - 📊 Sitzungshistorie einsehen - ⚙️ Konfiguration und Skills verwalten - 📅 Zeitgesteuerte Aufgaben einrichten - 📝 Logs anschauen

Häufige CLI-Befehle

BASH 
# Status anzeigen
openclaw status

# Healthcheck
openclaw doctor

# Verfügbare Modelle auflisten
openclaw models list

# Erinnerungen durchsuchen
openclaw memory search "Suchbegriff"

# Dokumentation öffnen
openclaw docs

# Gateway neu starten
openclaw gateway restart

# OpenClaw aktualisieren
openclaw update

Beispiel: Deine erste Aufgabe

Versuche folgendes in der Web-UI oder im Chat:

Erstelle eine Testdatei mit dem Inhalt "Hello OpenClaw!"

Suche nach den heutigen Tech-News

Lies die Datei readme.txt auf meinem Desktop und erstelle eine Zusammenfassung

Häufige Probleme und Lösungen

Problem 1: openclaw: command not found

Ursache: Der npm-Globalpfad ist nicht in PATH enthalten.

Lösung:

BASH 
# Pfad prüfen
npm prefix -g

# Zu ~/.bashrc hinzufügen
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Oder Terminal neu öffnen

Problem 2: WSL2-Netzwerkprobleme

Symptom: Abhängigkeiten oder APIs können nicht erreicht werden.

Lösung:

BASH 
# In Windows PowerShell ausführen
wsl --shutdown

# WSL neu starten
wsl

# DNS prüfen
cat /etc/resolv.conf

# Bei Bedarf öffentlichen DNS verwenden
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf

Problem 3: Berechtigungsfehler

Symptom: EACCES: permission denied

Lösung:

BASH 
# npm-Berechtigungen reparieren
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/.openclaw

# Oder nvm nutzen, um sudo zu vermeiden

Problem 4: Gateway startet nicht

Logs prüfen:

BASH 
openclaw gateway status
openclaw gateway logs

Häufige Ursachen: - Port bereits belegt (Standard: 18789) - Konfigurationsdatei fehlerhaft - API-Key ungültig

Lösung:

BASH 
# Port-Belegung prüfen
netstat -tlnp | grep 18789

# Neu konfigurieren
openclaw onboard

# Gateway neu starten
openclaw gateway restart

Problem 5: Node.js-Version zu alt

Version prüfen:

BASH 
node --version

Node.js aktualisieren:

BASH 
# Bei Verwendung von nvm
nvm install 22
nvm use 22
nvm alias default 22

# Bei Verwendung von NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

Erweiterte Konfiguration

Konfigurationsdatei bearbeiten

Die Konfigurationsdatei liegt unter ~/.openclaw/openclaw.json

Beispielkonfiguration:

JSON 
{
  "channels": {
    "webchat": {
      "enabled": true,
      "port": 18789
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    }
  },
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  },
  "skills": {
    "allowList": ["file.read", "file.write", "web.search"],
    "denyList": ["exec"]
  }
}

Umgebungsvariablen

Pfade lassen sich über Umgebungsvariablen anpassen:

BASH 
# Benutzerdefiniertes Konfigurationsverzeichnis
export OPENCLAW_HOME=/custom/path

# Benutzerdefiniertes Statusverzeichnis
export OPENCLAW_STATE_DIR=/custom/state

# Benutzerdefinierter Konfigurationspfad
export OPENCLAW_CONFIG_PATH=/custom/config.json

Sicherheitshärtung

Empfehlungen für Produktivumgebungen:

  1. Zugriff einschränken
JSON 
{
  "channels": {
    "webchat": {
      "allowFrom": ["192.168.1.0/24"]
    }
  }
}
  1. Authentifizierung aktivieren
JSON 
{
  "auth": {
    "required": true,
    "token": "your-secure-token"
  }
}
  1. Skill-Berechtigungen begrenzen
JSON 
{
  "skills": {
    "allowList": ["file.read", "web.search"],
    "denyList": ["exec", "file.delete"]
  }
}

Leistungsoptimierung

Speicher optimieren

Bei begrenztem Arbeitsspeicher:

JSON 
{
  "runtime": {
    "maxMemory": "2GB",
    "sessionLimit": 5
  }
}

Start optimieren

BASH 
# Unnötige Skills deaktivieren
openclaw skills disable unused-skill

# Leichtgewichtiges Modell verwenden
openclaw model set gemini-2.0-flash

Nächste Schritte

Nach der Installation kannst du:

  1. 📚 Offizielle Dokumentation lesen – docs.openclaw.ai
  2. 🔧 Skills-System erkunden – Verfügbare Skills und Beispiele anschauen
  3. 🤖 Automatisierung konfigurieren – Zeitgesteuerte Aufgaben und Erinnerungen einrichten
  4. 🔌 Weitere Kanäle verbinden – Telegram, WhatsApp usw. hinzufügen
  5. 👥 Community beitreten – Discord-Community

Zusammenfassung

Die vollständige Installation von OpenClaw unter Windows in fünf Schritten:

  1. ✅ WSL2 und Ubuntu installieren
  2. ✅ Node.js 22+ installieren
  3. ✅ OpenClaw-Installationsskript ausführen
  4. ✅ Initiale Konfiguration abschließen
  5. ✅ Loslegen!

Der gesamte Vorgang dauert etwa 10-15 Minuten. Die Schritte sehen zwar nach viel aus, aber die meisten sind einmalige Konfigurationen.

Wichtige Punkte: - ⚠️ WSL2 ist Pflicht – kein natives Windows versuchen - ⚠️ Node.js muss Version 22 oder höher sein - ⚠️ Nach der Installation openclaw doctor ausführen - ✅ Daemon installieren für automatischen Start beim Hochfahren

OpenClaw ist ein mächtiges Werkzeug. Sobald die Einrichtung abgeschlossen ist, wird es dein 24/7-KI-Assistent und hilft dir bei allem – von Dateiverwaltung über Informationssuche bis hin zu automatisierten Workflows.

Wenn du bei der Installation auf Probleme stößt, schau in die offizielle Dokumentation oder hinterlasse einen Kommentar!

Weiterführende Links: - OpenClaw Offizielle Dokumentation - OpenClaw GitHub-Repository - WSL2 Offizielle Dokumentation - Node.js Download - OpenClaw Community Discord

Vorschau auf den nächsten Artikel: Wir werden tiefer in das Skills-System von OpenClaw eintauchen und dir zeigen, wie du komplexe Workflows automatisieren kannst. Bleib dran!