OpenClaw ist ein lokales Tool, mit dem sich Ihr KI-agent mit Apps wie Telegram oder WhatsApp verbinden und Aktionen ausführen kann, etwa Nachrichten senden oder Aufgaben bearbeiten. Die Einrichtung ist unkompliziert, sobald Sie den Ablauf kennen. Dieser Leitfaden beschreibt die Installation unter macOS, Linux und Windows.
Kurzüberblick über die OpenClaw-Einrichtungsoptionen
Wählen Sie die Einrichtung, die zu Ihren Anforderungen passt. Wenn Sie OpenClaw lokal ausführen, bleibt alles auf Ihrem eigenen Rechner; dafür müssen Abhängigkeiten wie npm installiert oder ein automatisiertes Skript verwendet werden. Wenn Sie die Einrichtung überspringen möchten, übernehmen vollständig gehostete Plattformen wie Kimi Claw die Umgebung für Sie, sodass Sie direkt loslegen können.
| macOS / Linux | Windows | |
|---|---|---|
| Lokal ausführen | Einzeiliger Terminal-Befehl | Einzeiliger PowerShell-Befehl |
| Über npm | Über npm | |
| Über Homebrew | Über WSL2 | |
| Online ausführen | Cloudbasierte Lösung (z. B. Kimi Claw) | Cloudbasierte Lösung (z. B. Kimi Claw) |
OpenClaw unter macOS und Linux installieren
macOS und Linux verwenden denselben Installer und dieselben Befehle. Diese Anleitung gilt für beide Systeme, sofern nichts anderes angegeben ist.
Im Folgenden finden Sie eine kurze Einrichtungsanleitung. Eine vollständige Schritt-für-Schritt-Anleitung mit Screenshots finden Sie unter OpenClaw unter macOS installieren.
Methode 1: Einzeiligen Installer-Skript verwenden
Schritt 1: Installationsskript im Terminal ausführen
Führen Sie das offizielle Installationsskript aus, um OpenClaw einzurichten. Das Skript prüft, ob Node.js 22 oder neuer installiert ist. Falls Node.js fehlt oder veraltet ist, wird Node.js 24 automatisch installiert. Anschließend installiert es die OpenClaw-CLI und startet den Onboarding-Assistenten.
Schritt 2: Onboarding-Assistenten abschließen
Folgen Sie dem Onboarding-Assistenten, um Ihre agent-Umgebung einzurichten: Wählen Sie einen Modellanbieter (z. B. Kimi API), geben Sie Ihren API-Schlüssel ein, wählen Sie einen Kanal aus und konfigurieren Sie die Grundeinstellungen.
Schritt 3: Installation prüfen
Führen Sie den folgenden Befehl aus, um Ihre OpenClaw-Version zu bestätigen.
Schritt 4: Gateway prüfen und Einrichtung abschließen
Führen Sie den folgenden Befehl aus, um zu prüfen, ob das OpenClaw-Gateway aktiv ist.
Der Installer registriert außerdem unter macOS einen LaunchAgent oder unter Linux einen systemd-Dienst, sodass OpenClaw im Hintergrund weiterläuft. Sobald alles eingerichtet ist, ist Ihr agent einsatzbereit. Sie können mit dem Chatten beginnen, Tools verbinden oder Workflows nach Bedarf konfigurieren.
Methode 2: Mit Homebrew installieren
Schritt 1: Node.js installieren oder aktualisieren
Installieren Sie Node.js mit Homebrew, indem Sie den folgenden Befehl im Terminal ausführen. Wenn Node.js bereits installiert ist, führen Sie stattdessen den Upgrade-Befehl aus, damit Sie die neueste Version verwenden.
Schritt 2: OpenClaw-CLI installieren
Führen Sie den folgenden Befehl aus, um die OpenClaw-CLI global zu installieren.
Schritt 3: Onboarding ausführen und Daemon einrichten
Führen Sie den folgenden Befehl aus, um den Onboarding-Assistenten zu starten und den Hintergrund-Daemon zu registrieren. Folgen Sie dem Assistenten, um Ihre agent-Umgebung zu konfigurieren: Wählen Sie einen Modellanbieter (z. B. Kimi API), geben Sie Ihren API-Schlüssel ein und verbinden Sie einen Messaging-Kanal. Sobald die Einrichtung abgeschlossen ist, ist Ihr agent einsatzbereit. Sie können mit dem Chatten beginnen, Tools verbinden oder Workflows nach Bedarf konfigurieren.
Methode 3: Mit npm installieren
Schritt 1: Laufzeitversion prüfen
Führen Sie den folgenden Befehl aus, um sicherzustellen, dass Node.js 22.14 oder höher auf Ihrem System installiert ist. Ist Ihre Version aktuell, können Sie mit der Installation fortfahren.
Schritt 2: OpenClaw-CLI installieren
Führen Sie den folgenden Befehl aus, um die OpenClaw-CLI global zu installieren.
Schritt 3: Onboarding ausführen und Persistenz aktivieren
Führen Sie den folgenden Befehl aus, um den Onboarding-Assistenten zu starten und den Hintergrund-Daemon zu registrieren. Folgen Sie dem Assistenten, um Ihre agent-Umgebung zu konfigurieren: Wählen Sie einen Modellanbieter (z. B. Kimi API), geben Sie Ihren API-Schlüssel ein und wählen Sie einen Messaging-Kanal. Sobald die Einrichtung abgeschlossen ist, ist Ihr agent bereit. Sie können mit ihm interagieren, Tools verbinden oder Workflows nach Bedarf erstellen.
Plattformhinweise: OpenClaw unterstützt sowohl Intel- als auch Apple Silicon-Macs. Wenn die Installation durch Gatekeeper blockiert wird, können Sie sie in den Systemeinstellungen unter Datenschutz & Sicherheit zulassen.
OpenClaw unter Windows installieren
Unter Windows gibt es drei Hauptwege zur Installation von OpenClaw: den PowerShell-Installer für eine schnelle native Einrichtung, WSL2 für eine vollständige Linux-Umgebung und npm für die manuelle Installation.
Im Folgenden finden Sie eine kurze Einrichtungsanleitung. Eine vollständige Schritt-für-Schritt-Anleitung mit Screenshots finden Sie unter OpenClaw unter Windows installieren.
Methode 1: PowerShell-Installer verwenden (natives Windows)
Schritt 1: Installationsskript in PowerShell ausführen
Öffnen Sie PowerShell als Administrator und führen Sie das offizielle Einzeilen-Skript aus, um OpenClaw zu installieren.
Schritt 2: Onboarding-Assistenten abschließen
Folgen Sie den Onboarding-Schritten, um Ihre agent-Umgebung zu konfigurieren: Wählen Sie einen Modellanbieter (z. B. Kimi API), geben Sie Ihren API-Schlüssel ein und wählen Sie einen Messaging-Kanal.
Schritt 3: Installation überprüfen
Führen Sie den folgenden Befehl aus, um zu bestätigen, dass OpenClaw korrekt installiert ist und das Gateway aktiv ist.
Schritt 4: agent verwenden
Sobald die Einrichtung abgeschlossen ist, ist Ihr agent bereit. Sie können mit ihm interagieren, Tools verbinden oder Workflows nach Bedarf konfigurieren.
Methode 2: Mit WSL2 installieren
Schritt 1: Linux-Umgebung einrichten
Öffnen Sie PowerShell als Administrator und führen Sie den folgenden Befehl aus, um WSL2 zu aktivieren und zu initialisieren.
Schritt 2: Installer unter Linux ausführen
Öffnen Sie Ihr Linux-Terminal und führen Sie das Standard-Installationsskript aus, um OpenClaw zu installieren.
Schritt 3: Onboarding-Assistenten abschließen
Folgen Sie den Onboarding-Schritten, um Ihre agent-Umgebung zu konfigurieren: Wählen Sie einen Modellanbieter (z. B. Kimi API), geben Sie Ihren API-Schlüssel ein und wählen Sie einen Messaging-Kanal.
Sobald die Einrichtung abgeschlossen ist, ist Ihr agent bereit. Sie können mit ihm interagieren, Tools verbinden oder Workflows nach Bedarf konfigurieren.
Methode 3: Mit npm unter Windows installieren
Schritt 1: Node.js-Version prüfen
Führen Sie den folgenden Befehl aus, um zu prüfen, ob Node.js installiert und aktuell ist.
Schritt 2: OpenClaw-CLI installieren
Führen Sie den folgenden Befehl aus, um die OpenClaw-CLI global zu installieren.
Schritt 3: Onboarding ausführen und Persistenz aktivieren
Führen Sie den folgenden Befehl aus, um den Onboarding-Assistenten zu starten und den Hintergrund-Daemon zu registrieren.
Folgen Sie den Onboarding-Schritten, um Ihre agent-Umgebung zu konfigurieren: Wählen Sie einen Modellanbieter (z. B. Kimi API), geben Sie Ihren API-Schlüssel ein und wählen Sie einen Messaging-Kanal.
Sobald die Einrichtung abgeschlossen ist, ist Ihr agent bereit. Sie können mit ihm interagieren, Tools verbinden oder Workflows nach Bedarf konfigurieren.
OpenClaw online mit Kimi Claw ausführen
Die oben genannten Methoden erfordern ein Terminal, eine unterstützte Node.js-Version und einen Rechner, der eingeschaltet bleibt. Kimi Claw bietet eine vollständig gehostete Option, sodass Sie OpenClaw ohne Installation oder Wartung einer lokalen Umgebung ausführen können.
Schritt 1: Kimi Claw öffnen und eine Instanz erstellen
Gehen Sie zur Kimi Claw-Seite und klicken Sie auf Erstellen, um zu beginnen.
Schritt 2: Bereitstellung bestätigen
Bestätigen Sie die Bereitstellung im Pop-up-Fenster. Kimi Claw richtet Ihre OpenClaw-Umgebung einschließlich Gateway und Workspace automatisch ein – ganz ohne lokale Konfiguration.
Schritt 3: Workspace verwenden
Sobald die Bereitstellung abgeschlossen ist, öffnet sich Ihr Workspace im Dashboard. Sie können mit Ihrem agent interagieren, Skills einrichten, geplante Aufgaben konfigurieren und Dateien direkt im Browser verwalten.
Kernfunktionen von Kimi Claw
Cloud-Hosting: Kimi Claw betreibt Ihr Gateway in der Cloud, sodass Ihr agent auch dann verfügbar bleibt, wenn Ihr lokaler Rechner offline ist.
Automatische Wartung: Updates und Patches werden im Hintergrund eingespielt; manuelle Einrichtung oder Neustarts sind nicht erforderlich.
Integrierte Funktionen: Umfasst Aufgabenplanung, persistenten Speicher und dynamisches Laden von Skills auf Basis Ihrer Prompts – mit nahtlosem Zugriff über mehrere Geräte hinweg.
Fehlerbehebung bei häufigen OpenClaw-Installationsfehlern
Die meisten Probleme bei der OpenClaw-Installation fallen in wenige typische Kategorien, etwa PATH-Konfiguration, fehlende Abhängigkeiten oder Portkonflikte. Die folgenden Abschnitte helfen Ihnen, die häufigsten Probleme unter macOS, Windows und Linux schnell zu erkennen und zu beheben.
„openclaw: command not found“ nach der Installation
OpenClaw befindet sich nicht in Ihrem System-PATH.
Lösung: Fügen Sie das globale npm-bin-Verzeichnis zu Ihrem PATH hinzu.
Laden Sie anschließend Ihre Shell neu (z. B. source ~/.zshrc) oder starten Sie Ihr Terminal neu. Unter Windows fügen Sie den Pfad zu Ihren Umgebungsvariablen hinzu und starten PowerShell neu.
Sharp-Build-Fehler unter macOS
Das passiert in der Regel, wenn ein global installiertes libvips mit der Sharp-Bibliothek in Konflikt steht.
Lösung: Führen Sie den Installationsbefehl mit dieser Umgebungsvariablen aus.
Wenn node-gyp-Fehler angezeigt werden, installieren Sie die Xcode Command Line Tools:
OpenClaw startet nach dem Neustart nicht
Der Hintergrund-Daemon wurde beim Onboarding nicht installiert.
Lösung: Führen Sie das Onboarding erneut mit dem Daemon-Flag aus.
Prüfen Sie anschließend den Dienst:
Gateway reagiert nicht oder zeigt „0 tokens used“ an
Der Gateway-Prozess wurde möglicherweise beendet oder die API-Authentifizierung ist fehlgeschlagen.
Lösung: Starten Sie das Gateway neu.
Führen Sie einen Health Check aus:
Für Debugging-Logs:
Prüfen Sie außerdem, ob Ihr API-Schlüssel gültig ist.
Port 18789 wird bereits verwendet
Ein anderer Prozess verwendet den OpenClaw-Gateway-Port.
Lösung: Suchen und beenden Sie den Konflikt verursachenden Prozess
Starten Sie anschließend das Gateway neu:
EACCES-Berechtigungsfehler
Das bedeutet in der Regel, dass das globale npm-Verzeichnis nicht die richtigen Berechtigungen hat.
Lösung: Aktualisieren Sie die Verzeichniseigentümerschaft.
Unter Windows führen Sie PowerShell als Administrator aus oder legen einen benutzerdefinierten npm-Präfix fest:
Bei Docker-Setups korrigieren Sie die Volume-Berechtigungen:
Fehler „spawn git ENOENT“
Git ist nicht installiert oder nicht im PATH verfügbar.
Lösung: Installieren Sie Git von git-scm.com, starten Sie Ihr Terminal neu und versuchen Sie die Installation erneut.
WSL2 systemd funktioniert nicht
Systemd ist in Ihrer WSL-Konfiguration nicht aktiviert.
Lösung: Bearbeiten Sie
/etc/wsl.confund fügen Sie Folgendes hinzu.
Starten Sie anschließend WSL neu:
Öffnen Sie Ihr Linux-Terminal erneut und prüfen Sie:
Speichermangel während der npm-Installation auf VPS
VPS-Instanzen mit wenig Arbeitsspeicher können während der Paketinstallation fehlschlagen.
Lösung: Erstellen Sie eine Swap-Datei.
Führen Sie die Installation anschließend erneut aus.
„Access not configured“ beim Verbinden mit Messaging-Plattformen
Ihr Konto ist nicht von OpenClaw autorisiert.
Lösung: Genehmigen Sie Ihr Konto mit dem Pairing-Code.
Prüfen Sie außerdem, ob Ihre Bot-Zugangsdaten (token, Webhook, Berechtigungen) korrekt konfiguriert sind.
Fazit
Die Installation von OpenClaw ist unter macOS, Linux und Windows unkompliziert. Je nach Setup können Sie ein Ein-Zeilen-Skript, PowerShell, WSL2 oder npm verwenden. Der Onboarding-Assistent führt Sie durch Modellauswahl, API-Konfiguration und Messaging-Kanäle. Wenn Sie keine lokale Umgebung verwalten möchten, bietet Kimi Claw eine vollständig gehostete Option, mit der Sie OpenClaw direkt in der Cloud ausführen können.
FAQ
iwr -useb https://openclaw.ai/install.ps1 | iex) läuft nativ unter Windows 10 und Windows 11. Es übernimmt die Erkennung von Node.js, die CLI-Installation und das Onboarding, ohne WSL vorauszusetzen. Für Setups, die dauerhaft laufen sollen, wird WSL2 empfohlen, da systemd zuverlässigere Hintergrunddienste bietet. Für die allgemeine Nutzung funktioniert die native PowerShell-Installation sehr gut.node --version aus, um zu prüfen, ob Ihre Version die Mindestanforderung erfüllt.npm install -g openclaw@latest aus. Dadurch wird die CLI auf die neueste Version aktualisiert. Sie können auch den Einzeilen-Installer erneut ausführen; er aktualisiert Ihre bestehende Installation automatisch. OpenClaw unterstützt außerdem In-App-Updates über die Control UI unter 127.0.0.1:18789. Starten Sie nach dem Update das Gateway mit openclaw gateway restart neu, damit die neue Version geladen wird.openclaw gateway status aus, um zu prüfen, ob der Daemon aktiv ist. Unter Windows bietet WSL2 mit aktiviertem systemd die zuverlässigste Always-on-Einrichtung. Wenn Sie lokale Dienste nicht selbst verwalten möchten, können Sie OpenClaw mit vollständig gehosteten Optionen wie Kimi Claw dauerhaft in der Cloud ausführen.