OpenClaw lässt sich auf dem Mac auf verschiedene Weise installieren – je nachdem, wie du am liebsten arbeitest und deine Umgebung verwaltest. In dieser Anleitung findest du Schritt-für-Schritt-Anweisungen für unterschiedliche Installationsmethoden sowie Tipps, damit OpenClaw reibungslos läuft.
Kurzüberblick: drei Wege, OpenClaw auf dem Mac zu installieren
Hier findest du einen direkten Vergleich der drei Methoden. Sie unterscheiden sich vor allem darin, wie viel manuelle Einrichtung nötig ist.
| Ein-Zeilen-Installer | Homebrew | Kimi Claw (Online) | |
|---|---|---|---|
| Was es ist | Offizielles Installationsskript, das OpenClaw automatisch herunterlädt und einrichtet | Manuelle Einrichtung mit Homebrew zum Installieren von Abhängigkeiten (wie Node.js), anschließend Ausführen von OpenClaw über die CLI | Online-Tool, mit dem du OpenClaw ohne manuelle Einrichtung in der Cloud ausführen kannst |
| Erforderliche manuelle Schritte | Minimale manuelle Schritte | Mehrere manuelle Schritte erforderlich | Keine manuelle Einrichtung erforderlich |
| Code oder Terminal erforderlich | Ja | Ja | Nein |
| Verfügbarkeit rund um die Uhr | Läuft nur, solange dein Mac wach ist | Läuft nur, solange dein Mac wach ist | Läuft rund um die Uhr in der Cloud |
| Am besten geeignet für | Einsteiger, die die schnellste lokale Einrichtung wünschen | Entwickler, die Pakete lieber über Homebrew verwalten | Nutzer, die OpenClaw ohne lokale Einrichtung ausführen möchten |
Mit Kimi Claw kannst du OpenClaw in der Cloud ausführen, ohne Node.js, Homebrew oder API-Schlüssel einzurichten. Innerhalb weniger Minuten kannst du einen einsatzbereiten agent im Browser nutzen.
Wenn du eine lokale Einrichtung bevorzugst, lies im nächsten Abschnitt weiter. Wenn du es einfacher möchtest, springe zum Abschnitt OpenClaw auf dem Mac mit Kimi Claw ausführen oder klicke auf die Schaltfläche unten, um sofort loszulegen.
Bevor du beginnst: wichtige Vorbereitung und Sicherheit
Bevor du OpenClaw lokal auf dem Mac installierst, sind ein paar Vorbereitungs- und Sicherheitsschritte nötig. Wenn du Kimi Claw verwenden möchtest, kannst du diesen Abschnitt überspringen und direkt zu den Einrichtungsanweisungen unten gehen.
Abhängigkeiten: Der Ein-Zeilen-Installer installiert Node.js bei Bedarf automatisch. Wenn du Homebrew wählst, musst du Node.js manuell installieren (Node 24 empfohlen; Node 22 LTS 22.16+ funktioniert ebenfalls).
Firewall- und Netzwerkeinstellungen: Die macOS-Firewall ist normalerweise standardmäßig deaktiviert. Du kannst sie unter Systemeinstellungen > Netzwerk > Firewall aktivieren. OpenClaw bindet das Gateway an 127.0.0.1 (localhost), sodass andere Geräte in deinem Netzwerk nicht direkt darauf zugreifen können. Wenn du mobilen oder entfernten Zugriff benötigst, kannst du Tools wie Tailscale oder einen SSH-Tunnel verwenden. Leite Port
18789nicht über deinen Router weiter.
OpenClaw auf dem Mac mit dem Ein-Zeilen-Skript installieren
Das ist der schnellste Weg, OpenClaw lokal auf dem Mac auszuführen. OpenClaw läuft über Terminal und bietet statt einer klassischen grafischen App eine browserbasierte Oberfläche zur Verwaltung deines agent. Ein einziger Befehl installiert die CLI, prüft deine Node.js-Version und startet den Onboarding-Assistenten.
Schritt 1: Installationsskript im Terminal ausführen
Öffne Terminal über Spotlight (⌘ + Space) und füge dann den folgenden Befehl ein:
Das Skript erkennt dein System, installiert die OpenClaw-CLI und prüft deine Node.js-Version. Fehlt Node.js oder ist es veraltet, installiert es automatisch Node 24 (Node 22 LTS 22.16+ wird ebenfalls unterstützt).
Schritt 2: API-Schlüssel festlegen und Gateway konfigurieren
Der Onboarding-Assistent startet automatisch, sobald die Installation abgeschlossen ist. Wähle Moonshot AI (Kimi K2.5) als LLM-Anbieter aus und füge deinen Kimi API-Schlüssel ein, wenn du dazu aufgefordert wirst. Übernimm die Standardeinstellungen für Gateway-Port und Authentifizierung. Wenn OpenClaw beim Start deines Mac automatisch gestartet werden soll, wähle während des Onboardings die Option zur Daemon-Installation.
Schritt 3: Gateway prüfen und Dashboard öffnen
Führe den folgenden Befehl aus, um zu prüfen, ob das Gateway läuft:
Öffne anschließend das Dashboard:
Dieser Befehl öffnet die Control UI in deinem Browser unter http://127.0.0.1:18789. Gib dein Gateway-token ein, um dich anzumelden. Nach der Anmeldung kannst du mit deinem OpenClaw agent interagieren.
OpenClaw auf dem Mac mit Homebrew installieren
Wenn du Pakete lieber mit Homebrew verwaltest, kannst du OpenClaw auf dem Mac auch etwas manueller einrichten. Diese Methode gibt dir mehr Kontrolle über Abhängigkeiten und passt gut in deinen bestehenden Homebrew-Workflow.
Schritt 1: Homebrew installieren
Öffne Terminal über Spotlight (⌘ + Space). Falls Homebrew noch nicht installiert ist, führe den folgenden Befehl aus. Homebrew ist ein Paketmanager für macOS, mit dem du Entwicklertools im Terminal installieren und verwalten kannst – ähnlich wie ein App Store Apps installiert.
Während der Installation wirst du möglicherweise aufgefordert, dein Mac-Anmeldepasswort einzugeben. Beachte, dass Terminal aus Sicherheitsgründen während der Eingabe keine Zeichen anzeigt. Außerdem können Bestätigungsabfragen und Meldungen zu den installierten Dateien erscheinen.
Nach Abschluss der Installation siehst du im Terminal eine Erfolgsmeldung und die nächsten Schritte.
Schritt 2: Node.js installieren
Sobald Homebrew installiert ist, installiere Node.js:
Bestätige nach der Installation, dass die Version v24 (empfohlen) oder v22.16+ ist.
Schritt 3: OpenClaw-CLI installieren und Onboarding ausführen
Installiere die CLI global mit npm und führe dann das Onboarding aus:
Wenn während npm install -g ein EACCES-Berechtigungsfehler angezeigt wird, benötigt dein globales npm-Verzeichnis erhöhte Zugriffsrechte. Führe entweder sudo npm install -g openclaw@latest aus oder ändere dein npm-Standardverzeichnis, damit du künftig kein sudo mehr verwenden musst.
Das Flag --install-daemon registriert OpenClaw als LaunchAgent, sodass das Gateway beim Anmelden automatisch startet. Wähle während des Onboardings Moonshot AI (Kimi K2.5) als Anbieter aus und gib deinen Kimi API-Schlüssel ein.
Schritt 4: Gateway prüfen und Dashboard öffnen
Prüfe, ob das Gateway läuft, und öffne das Dashboard:
Die Control UI öffnet sich in deinem Browser. Gib dein Gateway-token ein – dann kann es losgehen.
OpenClaw auf dem Mac mit Kimi Claw ausführen
Kimi Claw ist ein Online-Tool, mit dem du OpenClaw ohne lokale Einrichtung in der Cloud ausführen kannst. Auf deinem Mac muss nichts installiert werden, und du musst weder Terminal verwenden noch Abhängigkeiten verwalten. Alles läuft im Browser. Einen OpenClaw agent kannst du in wenigen Minuten erstellen. Kimi Claw übernimmt Gateway, Workspace, Speicher und Modellzugriff, damit dein agent rund um die Uhr online bleibt – selbst wenn dein MacBook zugeklappt ist.
Wie nutzt man Kimi Claw?
Schritt 1: Kimi Claw öffnen
Gehe zur Kimi Claw-Seite und klicke auf Erstellen, um mit der Bereitstellung deiner OpenClaw-Umgebung zu beginnen.
Schritt 2: OpenClaw automatisch bereitstellen
Bestätige die Bereitstellung im Pop-up-Fenster. Kimi Claw richtet anschließend die OpenClaw-Umgebung ein, einschließlich Gateway, Workspace und Tools. Der Vorgang ist in der Regel nach wenigen Minuten abgeschlossen.
Schritt 3: OpenClaw verwenden
Nach Abschluss der Bereitstellung öffnet sich dein Workspace im Dashboard. Chate mit deinem agent, richte Skills ein, plane Aufgaben und verwalte Dateien – alles direkt im Browser.
Worin sich Kimi Claw von einer lokalen OpenClaw-Ausführung unterscheidet
Kimi Claw bietet eine einfachere Möglichkeit, OpenClaw ohne lokale Einrichtung auszuführen. Statt Abhängigkeiten zu installieren und eine lokale Umgebung zu verwalten, kannst du deinen agent direkt im Browser ausführen, während Kimi Claw die zugrunde liegende Einrichtung und Infrastruktur übernimmt.
Keine lokale Einrichtung erforderlich: Führe OpenClaw aus, ohne Node.js zu installieren oder Terminal zu verwenden. Alles funktioniert direkt im Browser, sodass du schneller loslegen und Probleme bei der Umgebungseinrichtung vermeiden kannst.
Sofortiger Zugriff auf über 5.000 Skills: Statt Tools manuell zu installieren, kann Kimi Claw automatisch die für deine Aufgabe benötigten Skills aus einer großen Bibliothek verfügbarer Tools nutzen. Das verkürzt die Einrichtung und reduziert Kompatibilitätsprobleme.
Always-on-Automatisierung und Zeitplanung: Anders als lokale agents, die stoppen, sobald dein Mac in den Ruhezustand wechselt, läuft Kimi Claw rund um die Uhr in der Cloud und eignet sich damit für geplante Aufgaben und lang laufende Workflows.
40 GB Cloud-Speicher und persistentes Gedächtnis: Anders als bei lokalen Setups, bei denen Dateien meist an ein einzelnes Gerät gebunden sind, enthält Kimi Claw 40 GB Speicher, sodass deine Berichte und Recherchen von jedem Browser aus zugänglich sind. Außerdem merkt es sich deine Präferenzen und deinen Arbeitskontext sitzungsübergreifend, damit du genau dort weitermachen kannst, wo du aufgehört hast.
Integriertes Kimi K2.5-Modell und Suche auf Profi-Niveau: Kimi Claw bietet integrierten Zugriff auf Kimi K2.5 und erweiterte Suchfunktionen, sodass du keine API-Schlüssel verwalten oder externen Dienste einrichten musst. Es kann automatisch aktuelle Informationen aus Bereichen wie Finanzen, Technologie und Nachrichten einbeziehen und macht Recherche und Aufgabenausführung dadurch nahtloser.
OpenClaw auf dem Mac rund um die Uhr laufen lassen
Die meisten Nutzer behandeln AI wie eine klassische Desktop-App: Man verwendet sie am Schreibtisch und schließt sie, wenn man fertig ist. Für nützliche Automatisierungen – etwa die Überwachung globaler Märkte über Nacht oder einen Recherchebericht, der um 8 Uhr morgens im Posteingang liegt – muss dein agent rund um die Uhr aktiv bleiben. Da macOS lokale Prozesse im Ruhezustand standardmäßig pausiert, braucht es dafür eine gezielte Strategie. In diesem Abschnitt werden zwei Möglichkeiten vorgestellt, eine dauerhafte Verbindung aufrechtzuerhalten:
Option A: Dedizierte Mac-Hardware
Eine Möglichkeit ist, einen Mac (zum Beispiel einen Mac mini) dauerhaft laufen zu lassen. Den Ruhezustand kannst du mit sudo pmset -a sleep 0 deaktivieren und in den Systemeinstellungen „Bei Netzwerkzugriff aufwachen“ aktivieren. Für den Remote-Zugriff kannst du Tools wie Tailscale oder einen SSH-Tunnel verwenden.
Mit diesem Setup läuft OpenClaw auf deiner eigenen Hardware weiter. Allerdings muss dein Rechner eingeschaltet bleiben, und Wartung, Updates sowie Neustarts liegen bei dir.
Option B: Kimi Claw übernimmt das automatisch
Wenn du deinen agent mit Kimi Claw ausführst, ist 24/7-Verfügbarkeit bereits integriert. Dein agent läuft unabhängig von deinem lokalen Gerät und arbeitet weiter, selbst wenn dein Mac zugeklappt oder offline ist. Du musst weder Ruhezustandseinstellungen anpassen noch einen Rechner dauerhaft betreiben.
Häufige OpenClaw-Installationsfehler auf dem Mac beheben
Auch bei einer einfachen Einrichtung können während der Installation Probleme auftreten. Hier findest du einige typische Fehler und ihre Lösungen.
Fehler: OpenClaw-Befehl nicht gefunden
Ursache: Das globale npm-bin-Verzeichnis befindet sich nicht in deinem Shell-PATH.
Lösung: Führe
source ~/.zshrcaus, um deine Shell-Konfiguration neu zu laden. Wenn du Bash statt Zsh verwendest, ersetze~/.zshrcdurch~/.bash_profile. Falls der Fehler weiterhin auftritt, ermittle dein npm-Präfix und füge es zu PATH hinzu:
OpenClaw startet nach einem Neustart nicht
Ursache: Der LaunchAgent wurde während des Onboardings nicht installiert.
Lösung: Führe den Onboarding-Befehl mit dem Daemon-Flag aus:
Dadurch wird ein LaunchAgent registriert, der das OpenClaw-Gateway beim Anmelden automatisch startet. So prüfst du, ob er aktiv ist:
Port 18789 wird bereits verwendet
Ursache: Ein anderer Prozess belegt den Gateway-Port.
Lösung: Finde und beende den konkurrierenden Prozess:
Fehler bei den Xcode Command Line Tools während der Skill-Installation
Ursache: Einige npm-Pakete erfordern native Kompilierung, und die Xcode Command Line Tools fehlen oder sind veraltet.
Lösung: Installiere oder aktualisiere die Tools:
Versuche nach Abschluss der Installation erneut, den Skill zu installieren.
Node.js-Version zu alt
Ursache: Auf deinem Mac ist eine Node.js-Version installiert, die älter als 22.16 ist. OpenClaw erfordert Node 24 (empfohlen) oder Node 22 LTS 22.16+.
Lösung: Wenn du Homebrew verwendet hast:
Wenn du den Einzeilen-Installer verwendet hast, führe ihn erneut aus. Das Skript erkennt die veraltete Version und aktualisiert sie.
Fazit
OpenClaw kann lokal auf deinem Mac mit dem Einzeilen-Installer oder Homebrew laufen – oder ohne lokale Einrichtung im Browser mit Kimi Claw. Jede Methode führt zu einem funktionsfähigen agent, erfordert aber unterschiedlich viel Handarbeit. Wenn du schneller starten möchtest und integrierte 24/7-Verfügbarkeit brauchst, kannst du mit Kimi Claw beginnen und deinen agent in wenigen Minuten zum Laufen bringen.
FAQ
openclaw onboard --install-daemon aus, um einen LaunchAgent zu registrieren, der das Gateway bei der Anmeldung startet. Wenn der Daemon bereits installiert ist, aber nicht startet, prüfe den Status mit launchctl list | grep openclaw und sieh dir die Systemprotokolle an. Nutzer von Kimi Claw brauchen diese Konfiguration nicht, weil der Dienst auf Cloud-Servern läuft und eigenständig online bleibt.source ~/.zshrc aus, um die Konfiguration neu zu laden. Wird der Befehl weiterhin nicht gefunden, führe npm config get prefix aus, um das Binärverzeichnis zu finden, und füge es in ~/.zshrc deinem PATH hinzu. Starte danach Terminal neu.sudo pmset -a sleep 0) und Fernzugriff über Tailscale ein, oder nutze Kimi Claw. Kimi Claw ist eine vollständig verwaltete Plattform, die deinen OpenClaw agent rund um die Uhr online hält – ohne Hardware, die du warten musst.curl -fsSL https://openclaw.ai/install.sh | bash aus. Das Skript installiert OpenClaw, prüft deine Node.js-Version und führt dich durch die Einrichtung. Alternativ kannst du Homebrew verwenden: Führe brew install node und anschließend npm install -g openclaw@latest aus. Wenn du eine vollständig verwaltete Option ohne Terminal möchtest, führt Kimi Claw OpenClaw direkt im Browser aus – ganz ohne lokale Einrichtung.curl -fsSL https://openclaw.ai/install.sh | bash) oder installiere über Homebrew mit npm install -g openclaw@latest. Wenn du eine browserbasierte Option ohne Download möchtest, betreibt Kimi Claw OpenClaw für dich auf Cloud-Servern.