OpenClaw installieren — Vollständige Installationsanleitung für Windows, Mac & Linux

Die Installation von OpenClaw dauert etwa 5 Minuten. Sie benötigen Node.js 22+, Git und 8 GB RAM. Der schnellste Weg ist ein einziger npm install -g openclaw@latest-Befehl, gefolgt vom Einrichtungsassistenten. Alternativ können Sie die Installation komplett überspringen mit dem MyClaw.ai Managed Hosting.

Was Sie vor der Installation von OpenClaw benötigen

Bevor Sie OpenClaw auf Ihrem Rechner installieren, stellen Sie diese Voraussetzungen sicher:

AnforderungMinimumEmpfohlenRAM8GB16GBSpeicher10GB20GBNode.jsv22v22+ (neuestes LTS)BSWin 10 (WSL2) / macOS 12 / Ubuntu 20.04Neueste stabile Version

Option 1: Installation überspringen mit Managed Hosting

Keine Lust auf Installation? MyClaw.ai bietet vollständig verwaltetes OpenClaw-Hosting — Ihre Instanz ist in Sekunden ohne jegliche Einrichtung bereit:

• Sofortige Einrichtung — Kein Installieren, kein Konfigurieren, keine Terminal-Befehle
• Immer verfügbar — 24/7-Betriebszeit, ohne Ihren Computer eingeschaltet zu lassen
• Automatische Updates — Immer die neueste OpenClaw-Version

Jetzt mit MyClaw.ai starten →

---

Option 2: OpenClaw selbst hosten

Es gibt zwei Wege zum Selbsthosting: die empfohlene globale Installation (am einfachsten) oder das Erstellen aus dem Quellcode (für Entwickler).

Empfohlen: Globale Installation

Dies ist der schnellste Weg, OpenClaw auf jeder Plattform zum Laufen zu bringen:

npm install -g openclaw@latest
openclaw onboard --install-daemon

Der Einrichtungsassistent führt Sie durch die Konfiguration Ihres Gateways, Arbeitsbereichs, der Kanäle und Skills. Das Flag --install-daemon richtet einen Hintergrunddienst ein (launchd auf macOS, systemd auf Linux), damit OpenClaw dauerhaft läuft.

Überprüfen Sie nach der Einrichtung Ihre Installation:

openclaw doctor

---

Alternative: Aus dem Quellcode erstellen

Wenn Sie volle Kontrolle bevorzugen oder zu OpenClaw beitragen möchten, können Sie aus dem Quellcode erstellen. Folgen Sie den plattformspezifischen Anleitungen unten.

OpenClaw unter Windows installieren

WSL2 wird dringend empfohlen für den Betrieb von OpenClaw unter Windows. Installieren Sie zuerst WSL2 und folgen Sie dann den Linux-Anweisungen unten.

Wenn Sie dennoch nativ unter Windows arbeiten möchten:

Schritt 1: Voraussetzungen installieren

1. Laden Sie Node.js v22+ herunter (LTS-Version)
2. Laden Sie Git für Windows herunter
3. Installieren Sie pnpm — OpenClaws bevorzugter Paketmanager
4. Starten Sie Ihr Terminal nach der Installation neu

Überprüfen Sie die Installationen:

node --version   # Sollte v22 oder neuer sein
git --version
pnpm --version

Schritt 2: OpenClaw-Repository klonen

Öffnen Sie PowerShell oder die Eingabeaufforderung und führen Sie aus:

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Schritt 3: Installieren und Erstellen

pnpm install
pnpm ui:build
pnpm build

Dies lädt alle erforderlichen Pakete herunter und erstellt das Projekt.

Schritt 4: Einrichtungsassistenten ausführen

pnpm openclaw onboard --install-daemon

Der Assistent führt Sie durch die Konfiguration von OpenClaw, einschließlich der Einrichtung Ihres KI-Modells, der Kanäle und des Arbeitsbereichs.

OpenClaw auf macOS installieren

Schritt 1: Voraussetzungen installieren

Der einfachste Weg ist mit Homebrew:

# Homebrew installieren, falls nötig
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Node.js und Git installieren
brew install node git

# pnpm installieren
brew install pnpm

Schritt 2: Klonen und Erstellen

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Schritt 3: Einrichtungsassistenten ausführen

pnpm openclaw onboard --install-daemon

Dies richtet einen launchd-Dienst ein, damit OpenClaw automatisch im Hintergrund läuft.

macOS-Berechtigungen

OpenClaw kann Zugriffsberechtigungen für Bildschirmaufnahme und Sprachfunktionen anfordern. Wenn Sie dazu aufgefordert werden, gehen Sie zu:

Systemeinstellungen > Datenschutz & Sicherheit > Bedienungshilfen

Fügen Sie Ihre Terminal-Anwendung zur Erlaubnisliste hinzu.

OpenClaw auf Linux (Ubuntu/Debian) installieren

Schritt 1: Voraussetzungen installieren

# Paketmanager aktualisieren
sudo apt update

# Node.js 22 über NodeSource installieren
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Git installieren
sudo apt install -y git

# pnpm installieren
npm install -g pnpm

Schritt 2: Klonen und Erstellen

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Schritt 3: Einrichtungsassistenten ausführen

pnpm openclaw onboard --install-daemon

Dies richtet einen systemd-Benutzerdienst ein, damit OpenClaw dauerhaft im Hintergrund läuft.

Fehlerbehebung häufiger Installationsprobleme

"pnpm install" schlägt mit Berechtigungsfehlern fehl

Verwenden Sie unter Linux/macOS kein sudo mit pnpm oder npm. Beheben Sie stattdessen die Berechtigungen:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Fehler "Node-Version nicht unterstützt"

OpenClaw erfordert Node.js 22 oder neuer:

node --version

Wenn Ihre Version älter ist, laden Sie die neueste von nodejs.org herunter oder verwenden Sie nvm zur Versionsverwaltung:

nvm install 22
nvm use 22

Port bereits in Verwendung

Eine andere Anwendung verwendet denselben Port. Entweder:

• Beenden Sie die konfliktverursachende Anwendung
• Geben Sie einen anderen Port an: openclaw gateway --port 18790

Fehlende native Abhängigkeiten

Unter Linux benötigen Sie möglicherweise zusätzliche Build-Tools:

sudo apt install build-essential

Diagnose-Tool ausführen

OpenClaw enthält einen integrierten Diagnosebefehl, der Ihre Konfiguration überprüft:

openclaw doctor

Installation überprüfen

Führen Sie nach der Installation von OpenClaw das Diagnose-Tool aus, um sicherzustellen, dass alles funktioniert:

openclaw doctor

Testen Sie dann mit einem einfachen Agent-Befehl:

openclaw agent --message "Hallo, funktionierst du?"

Wenn OpenClaw antwortet, ist Ihre Installation abgeschlossen.

OpenClaw aktualisieren

Um Ihre OpenClaw-Installation auf die neueste Version zu aktualisieren:

Bei globaler Installation:

openclaw update --channel stable

Bei Erstellung aus dem Quellcode:

cd openclaw
git pull origin main
pnpm install
pnpm ui:build
pnpm build

Nächste Schritte

Nachdem OpenClaw installiert ist:

• Lesen Sie die Erste-Schritte-Anleitung, um die grundlegende Nutzung zu erlernen
• Erfahren Sie mehr darüber, Was ist OpenClaw
• Entdecken Sie OpenClaw-Hosting-Optionen für den 24/7-Betrieb