Installationsanleitung

OpenClaw von Grund auf installieren ist eigentlich ganz einfach! Folge einfach den Schritten unten, in etwa 5-10 Minuten bist du fertig. Keine Sorge, wir erklären jeden Schritt.

📋 Systemanforderungen

Bevor du mit der Installation beginnst, stelle sicher, dass dein Computer diese Grundvoraussetzungen erfüllt:

Node.js 22 oder höher — Das ist die Laufzeitumgebung für OpenClaw (keine Sorge, das Installationsskript prüft das für dich)
Betriebssystem — macOS, Linux oder Windows (WSL2 erforderlich)
Arbeitsspeicher — Mindestens 2 GB freier RAM
Festplattenspeicher — Mindestens 500 MB freier Speicherplatz
Netzwerk — Internetverbindung zum Herunterladen und für KI-Modell-API-Aufrufe

ℹ️ Was ist Node.js? Einfach gesagt ist Node.js so etwas wie ein "Übersetzer", der es deinem Computer ermöglicht, in JavaScript geschriebene Programme auszuführen. OpenClaw ist in JavaScript geschrieben, deshalb braucht es Node.js. Du musst JavaScript nicht lernen — du musst nur Node.js installieren.

ℹ️ Was ist WSL2? Windows-Nutzer aufgepasst: OpenClaw läuft nicht direkt unter Windows, sondern benötigt WSL2 (Windows Subsystem for Linux 2). Das ist im Grunde ein Mini-Linux-System innerhalb von Windows. Wenn du Windows verwendest, kümmert sich das Installationsskript automatisch darum.

🌟 Methode 1: Ein-Klick-Installationsskript (Empfohlen für Einsteiger!)

Das ist die einfachste Installationsmethode. Du musst nur einen einzigen Befehl im Terminal kopieren und einfügen, und das Skript erledigt alles automatisch. Es ist wirklich ganz einfach, folge einfach den Anweisungen!

💡 Was ist ein "Terminal"? Das Terminal ist ein Fenster, in das du Textbefehle eingeben kannst. Auf macOS heißt es "Terminal", auf Windows "PowerShell" oder "Eingabeaufforderung". Du kannst auf deinem Computer nach "Terminal" suchen, um es zu finden.

Terminal öffnen

Drücke Command + Leertaste, tippe "Terminal" ein und drücke Enter. Ein schwarzes (oder weißes) Befehlszeilenfenster öffnet sich.

Installationsbefehl kopieren und einfügen

Kopiere den folgenden Befehl, füge ihn im Terminal-Fenster ein und drücke Enter:

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

Dieser Befehl macht Folgendes:

Prüft, ob Node.js auf deinem Computer installiert ist, und installiert es bei Bedarf automatisch
Lädt die neueste Version von OpenClaw herunter und installiert sie
Startet den Konfigurationsassistenten (Onboarding), der dich durch die Grundeinrichtung führt

Auf Abschluss der Installation warten

Die Installation dauert etwa 2-5 Minuten, je nach Internetgeschwindigkeit. Du siehst im Terminal jede Menge Text durchlaufen — das ist ganz normal, keine Sorge! Nach Abschluss der Installation startet automatisch der Konfigurationsassistent.

Terminal öffnen

Unter Linux kannst du Ctrl + Alt + T drücken, um das Terminal zu öffnen, oder im Anwendungsmenü nach "Terminal" suchen.

Installationsbefehl kopieren und einfügen

Genau wie bei macOS: Kopiere den folgenden Befehl, füge ihn im Terminal ein und drücke Enter:

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

Das Skript prüft automatisch Node.js, lädt OpenClaw herunter und startet den Konfigurationsassistenten.

Auf Abschluss der Installation warten

Warte ein paar Minuten geduldig. Wenn du den Konfigurationsassistenten siehst, war die Installation erfolgreich!

PowerShell öffnen (als Administrator ausführen)

Suche im Startmenü nach "PowerShell", klicke mit der rechten Maustaste darauf und wähle "Als Administrator ausführen". Dieser Schritt ist wichtig, da die Installation Administratorrechte benötigt.

Installationsbefehl kopieren und einfügen

Windows-Nutzer verwenden diesen speziellen Befehl:

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

Dieses Skript erledigt automatisch Folgendes:

Prüft und konfiguriert WSL2 (falls noch nicht installiert)
Installiert Node.js
Lädt OpenClaw herunter und installiert es
Startet den Konfigurationsassistenten

Auf Abschluss der Installation warten

Unter Windows kann die Installation etwas länger dauern (da möglicherweise WSL2 installiert werden muss), etwa 5-10 Minuten. Nach Abschluss startet automatisch der Konfigurationsassistent.

⚠️ Hinweis für Windows-Nutzer: Nach der Installation von WSL2 muss möglicherweise ein Neustart durchgeführt werden. Wenn das Skript dich zum Neustart auffordert, starte zuerst den Computer neu und führe dann den Installationsbefehl erneut aus.

📦 Methode 2: Installation über npm

Wenn du bereits mit Node.js und npm (dem Paketmanager von Node.js) vertraut bist, kannst du diese Methode verwenden. Sie gibt dir mehr Kontrolle.

Node.js-Installation überprüfen

Öffne das Terminal und gib folgenden Befehl ein, um die Node.js-Version zu prüfen:

node --version

Wenn v22.x.x oder höher angezeigt wird, bist du startklar. Falls nicht installiert oder die Version zu niedrig ist, lade zuerst die neueste Version von nodejs.org herunter.

OpenClaw global mit npm installieren

Führe im Terminal folgenden Befehl aus:

npm install -g openclaw@latest

Erklärung des Befehls:

npm install — Verwendet npm zum Installieren von Software
-g — Globale Installation, damit der Befehl openclaw überall verfügbar ist
openclaw@latest — Installiert die neueste Version von OpenClaw

Ersteinrichtung starten und Hintergrunddienst registrieren

Nach der Installation führe folgenden Befehl aus:

openclaw onboard --install-daemon

Dieser Befehl macht zwei Dinge:

onboard — Startet den Konfigurationsassistenten, der dich durch die Ersteinrichtung führt (KI-Modell auswählen, API-Schlüssel eingeben usw.)
--install-daemon — Registriert OpenClaw als Hintergrunddienst (Daemon), sodass es beim Computerstart automatisch startet und du es nicht jedes Mal manuell öffnen musst

💡 Was ist ein Daemon (Hintergrundprozess)? Einfach gesagt: Ein Programm, das leise im Hintergrund läuft. Du siehst kein Fenster, aber es arbeitet die ganze Zeit. Mit --install-daemon läuft OpenClaw still im Hintergrund und wartet jederzeit auf deine Nachrichten.

🐳 Methode 3: Installation mit Docker

Wenn du gerne Docker (eine Containerisierungstechnologie) verwendest oder OpenClaw in einer komplett isolierten Umgebung laufen lassen möchtest, ist diese Methode die richtige Wahl.

ℹ️ Was ist Docker? Docker ist so etwas wie eine "virtuelle Box", in der du Software laufen lassen kannst. Selbst wenn die Software Probleme macht, wird dein Computer nicht beeinträchtigt. Wenn du nicht weißt, was Docker ist, empfehlen wir Methode 1 oder 2 für die Installation.

Sicherstellen, dass Docker installiert ist

Falls du Docker noch nicht installiert hast, lade Docker Desktop von docker.com herunter und installiere es.

OpenClaw Docker-Container starten

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest

Dieser Befehl lädt das OpenClaw Docker-Image herunter und startet den Container. Der Parameter -v verbindet die Konfigurationsdateien mit deinem Computer, damit keine Daten verloren gehen.

✅ Überprüfung nach der Installation

Nach Abschluss der Installation lass uns sicherstellen, dass alles richtig funktioniert. Folge diesen Schritten:

Gesundheitscheck durchführen

openclaw doctor

Dieser Befehl ist wie eine "Untersuchung" für OpenClaw. Er prüft, ob alle notwendigen Komponenten ordnungsgemäß funktionieren. Wenn alles in Ordnung ist, siehst du lauter grüne Häkchen.

Laufstatus prüfen

openclaw status

Dieser Befehl zeigt dir, ob OpenClaw gerade läuft. Wenn "running" angezeigt wird, ist alles in Ordnung!

Web-Dashboard öffnen

openclaw dashboard

Dieser Befehl öffnet automatisch deinen Browser und ruft das OpenClaw Web-Dashboard auf. Die Adresse lautet:

http://127.0.0.1:18789/

Im Dashboard kannst du alle Einstellungen und den Status von OpenClaw sehen — sehr übersichtlich!

🎉 Wenn alle drei Befehle ohne Fehler durchlaufen sind, herzlichen Glückwunsch! OpenClaw wurde erfolgreich installiert! Gehe jetzt zum Abschnitt Schnellstart, um zu erfahren, wie du loslegst.

🛠️ Häufige Installationsprobleme

Keine Panik, wenn etwas nicht klappt! Hier sind die häufigsten Probleme bei der Installation und ihre Lösungen:

Problem 1: Befehl nicht gefunden (command not found: openclaw)

Das liegt meistens an der PATH-Umgebungsvariable. Einfach gesagt: Dein Computer weiß nicht, wo sich der Befehl openclaw befindet.

Lösung:

# Prüfen, wo openclaw installiert ist
which openclaw || npm list -g openclaw

# Für bash: Pfad zur Konfigurationsdatei hinzufügen
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Für zsh (Standard auf macOS)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Problem 2: Node.js-Version zu niedrig

Wenn du einen Fehler wie "Node.js v18 is not supported" siehst, musst du Node.js aktualisieren.

Lösung:

# nvm (Node Version Manager) zum Verwalten von Node.js-Versionen verwenden
# Zuerst nvm installieren
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Node.js 22 installieren
nvm install 22

# Zu Node.js 22 wechseln
nvm use 22

# Version überprüfen
node --version

Problem 3: Port-Konflikt (EADDRINUSE)

Wenn du die Meldung "EADDRINUSE: address already in use :::18789" siehst, wird Port 18789 bereits von einem anderen Programm verwendet.

Lösung:

# Prozess finden, der Port 18789 belegt
lsof -i :18789

# Falls es ein alter OpenClaw-Prozess ist, zuerst stoppen
openclaw stop

# Dann neu starten
openclaw start

Problem 4: Fehlende Berechtigungen (EACCES)

Beim globalen Installieren mit npm unter Linux/macOS können Berechtigungsprobleme auftreten.

Lösung:

# Methode A: npm-Globalinstallationsverzeichnis ändern
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Dann erneut installieren
npm install -g openclaw@latest

⚠️ Verwende niemals sudo npm install -g! Auch wenn sudo das Berechtigungsproblem löst, kann es andere Sicherheitsprobleme verursachen. Bitte verwende stattdessen die oben beschriebene Methode, um das npm-Globalinstallationsverzeichnis zu ändern.

Problem 5: Netzwerk-Timeout

Wenn der Download langsam ist oder abbricht, liegt das möglicherweise an Netzwerkproblemen.

Lösung:

# npm-Registry auf einen alternativen Mirror setzen
npm config set registry https://registry.npmmirror.com

# Dann erneut installieren
npm install -g openclaw@latest