RobotsHelp

OpenClaw auf dem Mac installieren: Menüleisten-App oder Terminal, Schritt für Schritt

Du hörst ständig von OpenClaw und möchtest es heute Abend auf deinem Mac installieren. Doch in der Anleitung stehen plötzlich eine Menüleisten-App, ein Terminal-Befehl, npm und ein Begriff namens Gateway. Welchen Weg sollst du nehmen? Und was ist, wenn dein Mac schon ein paar Jahre alt ist?

Hier ist die kurze Antwort. Wenn auf deinem Mac macOS Tahoe 26.2 oder neuer läuft, installierst du OpenClaw am einfachsten über die Menüleisten-App: Lade die DMG-Datei von der OpenClaw-Releases-Seite herunter, ziehe OpenClaw in den Ordner „Programme“, öffne die App und wähle This Mac für die Einrichtung auf diesem Mac. Den Rest erledigt die App selbst. Für diesen Teil brauchst du weder Terminal noch Homebrew oder Adminrechte. Auf einem älteren Mac, oder wenn du lieber das Terminal nutzt, reicht ein Befehl: curl -fsSL https://openclaw.ai/install.sh | bash. In beiden Fällen brauchst du Zugang zu einem KI-Modell: einen vorhandenen Codex- oder Claude-Login oder einen API-Schlüssel. Laut Dokumentation kannst du nach wenigen Minuten den ersten Chat starten. Plane lieber 20 Minuten ein, damit du alles in Ruhe mitlesen kannst. Die Schritte für beide Wege findest du unten.

Möchtest du jede Woche eine praktische KI-Lektion wie diese?

No password needed – your reset opens instantly.

Kein Passwort. Nur deine E-Mail-Adresse, und du bist dabei.

Bevor du loslegst: Prüfe zwei Dinge auf deinem Mac

Öffne oben links das Apple-Menü und wähle Über diesen Mac. Dieses Fenster beantwortet beide Fragen.

  • Deine macOS-Version. Im Fenster stehen der Name und die Versionsnummer (Apple: Welche macOS-Version verwendet dein Mac?). Die OpenClaw-App braucht macOS 26.2 (Tahoe) oder neuer. Über das Terminal geht es auch mit älteren Versionen: Die Node-Versionen, auf denen OpenClaw läuft, sind für macOS 13.5 oder neuer ausgelegt. Auf älteren macOS-Versionen „laufen sie möglicherweise noch, werden aber nicht unterstützt“ (OpenClaw-Dokumentation: macOS-App).
  • Dein Chip. Steht dort Chip, gefolgt von einem Namen wie M1 oder M3, hast du einen Mac mit Apple-Chip. Steht dort Prozessor mit einem Intel-Namen, hast du einen Intel-Mac (Apple: Mac-Computer mit Apple-Chip). OpenClaw bietet für beide einen eigenen Download. Falls du dir nicht sicher bist, gibt es auch eine Universal-Version.

Außerdem brauchst du Zugang zu einem KI-Modell. OpenClaw selbst ist kostenlos und Open Source unter der MIT-Lizenz. Die Denkarbeit übernimmt das Modell dahinter, und dafür bezahlst du. Bei der Einrichtung kannst du einen vorhandenen Codex- oder Claude-Login oder einen API-Schlüssel von OpenAI oder Anthropic verwenden.

Du überlegst noch, ob OpenClaw überhaupt das richtige Tool für dich ist? Lies zuerst OpenClaw vs Claude Code oder OpenClaw vs Claude Cowork. Diese Seite setzt voraus, dass du dich schon entschieden hast.

Welcher Installationsweg passt zu deinem Mac?

  • Die Menüleisten-App (OpenClaw.app). Eine normale Mac-App mit einem Symbol in der Menüleiste, einem Dashboard, einem Chatfenster und einer Leiste namens Quick Chat für kurze Chats. Sie bringt ihre eigene Laufzeitumgebung mit. Du musst Node also nicht separat installieren. Am besten geeignet, wenn du macOS 26.2 oder neuer nutzt und lieber ohne Terminal arbeitest.
  • Die Installation über das Terminal. Ein Befehl installiert bei Bedarf Node, installiert OpenClaw und führt dich durch die Einrichtung. Am besten für ältere Macs oder wenn du gern siehst, was gerade passiert.
  • npm. Nur wenn du Node bereits selbst verwaltest. Dazu findest du unten einen kurzen Abschnitt.

Ein Begriff wird dir überall begegnen: das Gateway. Das ist der Teil von OpenClaw, der im Hintergrund läuft, deine Einstellungen speichert und deine Chat-Apps mit der KI verbindet. Am Ende läuft bei beiden Wegen ein Gateway auf deinem Mac.

OpenClaw auf dem Mac mit der Menüleisten-App installieren

  1. Lade die passende DMG-Datei herunter. Öffne die OpenClaw-Releases-Seite auf GitHub und wähle die DMG-Datei für Apple Silicon, Intel oder Universal. Als diese Seite geschrieben wurde, verwies die Dokumentation auf Version 2026.10.3. Sie weist auch darauf hin, dass manche Versionen nur Dateien für die Kommandozeile (CLI) oder für Windows enthalten. Falls die neueste Version keine Mac-App enthält, nimm die neueste Version mit Mac-App.
  2. Verschiebe die App in „Programme“. Öffne die DMG-Datei und ziehe OpenClaw in deinen Ordner „Programme“. Starte die App nicht aus „Downloads“ oder direkt aus dem Disk-Image. Die Seite zu Berechtigungen erklärt den Grund: macOS verknüpft Berechtigungen mit dem Speicherort der App. Eine veröffentlichte App-Version sollte unter /Applications/OpenClaw.app laufen, damit deine erteilten Berechtigungen erhalten bleiben (OpenClaw-Dokumentation: macOS-Berechtigungen).
  3. Öffne die App und bestätige zwei Abfragen. macOS fragt, ob du eine heruntergeladene App öffnen möchtest. Klicke auf Öffnen. Dann fragt es, ob OpenClaw Geräte in deinem lokalen Netzwerk finden darf. Klicke auf Erlauben. Damit kann die App ein Gateway auf einem anderen Rechner erreichen (OpenClaw-Dokumentation: Einrichtung der macOS-App).
  4. Lies den Sicherheitshinweis. Er erklärt, dass OpenClaw standardmäßig als persönlicher Agent für eine einzelne vertrauenswürdige Person gedacht ist. Fahre fort, wenn das zu deiner Nutzung passt.
  5. Wähle This Mac. Ein Fenster namens Getting things ready bereitet die mitgelieferte Laufzeitumgebung vor, startet das Gateway und prüft es. Laut Dokumentation brauchst du dafür keinen Download einer Laufzeitumgebung, kein Node, kein Terminal, kein Homebrew und keine Administratorrechte. Für die Verbindung mit einem KI-Anbieter kann weiterhin eine Internetverbindung nötig sein (OpenClaw-Dokumentation: Gateway unter macOS).
  6. Lass die App die Verbindung zur KI einrichten. Die App prüft der Reihe nach: gespeicherte OpenClaw-Anmeldungen, einen Codex-Login, einen Claude-CLI-Login, einen OPENAI_API_KEY oder ANTHROPIC_API_KEY und bereits geladene Modelle in Ollama, LM Studio oder llama.cpp. Sie testet jede Option mit einer echten Anfrage und nimmt die erste, die funktioniert. Funktioniert keine, richtet sie das offizielle Codex-Plugin ein und bietet dir eine Anmeldung bei ChatGPT an. Im Dashboard siehst du, was sie ausgewählt hat, und kannst die Auswahl ändern.
  7. Schließe die Einrichtung im Dashboard ab. Ein geführtes Gespräch hilft dir beim Rest: gespeichertes Wissen importieren, Chat-Kanäle verbinden und Berechtigungen vergeben. Alles ist optional und lässt sich später nachholen.

Eine Einstellung solltest du gleich kennen. Nach einer frischen Einrichtung betreibt die App das Gateway selbst. Wenn du die App beendest, stoppt deshalb auch das Gateway. Soll OpenClaw bei geschlossener App weiterarbeiten, aktiviere Keep OpenClaw running when the app is closed. Diese Option findest du in den Geräteeinstellungen des Dashboards neben Launch at login, dem automatischen Start bei der Anmeldung. Standardmäßig ist sie ausgeschaltet. Probiere auch Quick Chat aus: Drücke die Wahltaste und die Leertaste. So öffnest du eine Chatleiste ähnlich wie Spotlight, ohne ein vollständiges Fenster zu öffnen.

OpenClaw auf dem Mac über das Terminal installieren

Auf einem älteren Mac, oder wenn dir dieser Weg einfach lieber ist: Drücke die Befehlstaste und die Leertaste, gib Terminal ein und drücke die Eingabetaste. Füge dann diesen Befehl ein:

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

Das Skript prüft deine Node-Version und installiert Node 26 über Homebrew, falls Node fehlt. Homebrew wird nur installiert, wenn es für Node oder Git gebraucht wird (OpenClaw-Dokumentation: So arbeitet das Installationsskript). Danach installiert es OpenClaw und startet den Einrichtungsassistenten. So geht es weiter:

  1. Wähle Quick start. Diese Schnelleinrichtung findet einen vorhandenen Codex- oder Claude Code-Login oder einen API-Schlüssel. Sie testet den Zugang mit einer echten Anfrage, speichert deine Einstellungen und öffnet das Web-Dashboard (OpenClaw-Dokumentation: Erste Schritte).
  2. Lass OpenClaw im Hintergrund laufen. Quick start hält das Gateway in diesem Terminalfenster am Laufen. Drücke Control-C, um es zu stoppen, und führe dann openclaw gateway install aus. Auf dem Mac erstellt das einen LaunchAgent. Damit startet das Gateway bei der Anmeldung und wird nach einem Absturz neu gestartet. Deine Einstellungen bleiben gespeichert.
  3. Prüfe die Installation:
openclaw --version
openclaw doctor
openclaw gateway status

Der Status sollte anzeigen, dass das Gateway auf Port 18789 auf Verbindungen wartet. Führe dann openclaw dashboard aus, um die Control UI, also die Bedienoberfläche, im Browser zu öffnen. Wenn sie lädt, funktioniert alles.

Du verwaltest Node schon selbst? Die Dokumentation nennt diesen Weg für npm 12 oder 11.16 und neuer. Bei npm 11.15 oder älter lässt du --allow-scripts=openclaw weg:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

OpenClaw braucht Node 24.16+ oder 26.1+. Empfohlen wird Node 26 (OpenClaw-Dokumentation: Installation).

Mac-Berechtigungen einfach erklärt

Bei den Berechtigungen wird es bei den meisten Mac-Installationen unübersichtlich. Nimm dir deshalb hier zwei Minuten Zeit. macOS verlangt separate Berechtigungen für Bildschirm, Mikrofon, Dateien und die Steuerung per Tastatur. OpenClaw fragt erst danach, wenn ein Tool eine Berechtigung braucht: Im Chat erscheint eine Karte mit Grant zum Erteilen der Berechtigung. Der Agent wartet auf dich, bevor er es erneut versucht.

  • Erlaube, was du nutzt, nicht alles. Die vollständige Liste findest du unter Dashboard > Settings > This Mac > Permissions: Automation, Notifications, Accessibility, Screen Recording, Microphone, Speech Recognition, Camera und Location. Gemeint sind Automatisierung, Mitteilungen, Bedienungshilfen, Bildschirmaufnahme, Mikrofon, Spracherkennung, Kamera und Standort. Für Schreiben und Recherchieren im Chat kannst du weitreichende Berechtigungen ausgeschaltet lassen, bis ein Tool danach fragt.
  • Screen Recording wird weiterhin als fehlend angezeigt? Klicke auf Grant und aktiviere OpenClaw in den Systemeinstellungen unter Datenschutz & Sicherheit > Aufnahme von Bildschirm & Systemaudio. Beende OpenClaw anschließend und öffne es erneut.
  • Gib „node“ nie Zugriff auf die Bedienungshilfen. Die Dokumentation weist darauf hin: Hat ein node-Eintrag diese Berechtigung, kann jedes Skript, das über diese Node-Installation läuft, die Oberfläche deines Macs steuern. Erteile die Berechtigung stattdessen OpenClaw.app. Entferne einen node-Eintrag, falls du ihn versehentlich hinzugefügt hast.
  • Der Zugriff auf Dateien auf dem Schreibtisch oder in „Dokumente“ hängt? macOS blockiert unter Umständen den Zugriff von Hintergrundprozessen auf diese Ordner. Die einfache Lösung aus der Dokumentation: Lege die Dateien, mit denen OpenClaw arbeiten soll, in seinen eigenen Arbeitsordner: ~/.openclaw/workspace.

Noch ein Tipp zum Speicherort: Lass die Daten von OpenClaw auf dem eigenen Laufwerk deines Macs, nicht in iCloud Drive oder einem anderen synchronisierten Ordner. Laut Dokumentation können Verzögerungen beim Synchronisieren und Dateisperren dazu führen, dass Sitzungen und Zugangsdaten nicht mehr funktionieren. openclaw doctor weist dich darauf hin, wenn deine Daten in einem synchronisierten Ordner liegen.

Deine ersten 15 Minuten nach der Installation

Die Installation lohnt sich erst, wenn OpenClaw eine Aufgabe für dich erledigt. Mach deshalb direkt diese drei Dinge:

  1. Sende eine erste Nachricht. Nimm etwas Kleines aus deinem Alltag: „Mach aus diesen Notizen eine Checkliste für morgen früh: [hier einfügen]“. Wenn du eine Antwort bekommst, funktioniert die Verbindung zur KI.
  2. Verbinde Telegram, wenn du OpenClaw vom Handy aus schreiben möchtest. Laut Dokumentation ist dieser Kanal am schnellsten eingerichtet, weil du nur einen Bot-Token brauchst. Standardmäßig bekommt jede neue Person, die deinem Bot schreibt, einen Kopplungscode mit 8 Zeichen. Ihre Nachrichten werden erst verarbeitet, wenn du die Kopplung bestätigst. Die Codes laufen nach einer Stunde ab (OpenClaw-Dokumentation: Kopplung).
  3. Starte den Sicherheitscheck: openclaw security audit. Er zeigt dir, ob deine Einrichtung von den sicheren Standardeinstellungen abweicht (OpenClaw-Dokumentation: Sicherheit). Behebe die gemeldeten Punkte, bevor du weitere Kanäle hinzufügst.

Gib OpenClaw danach eine Aufgabe, die jede Woche wiederkehrt. Zum Beispiel eine Zusammenfassung deiner Notizdatei am Freitag. Wenn du Agenten lieber mit Drag-and-drop-Tools bauen möchtest, lies so erstellst du einen KI-Agenten ohne Code.

Kann auch das KI-Modell auf deinem Mac laufen?

Ja, aber du solltest wissen, was dazugehört. Wenn du bereits ein Modell in Ollama, LM Studio oder llama.cpp geladen hast, kann die App es bei der Einrichtung finden. Laut Dokumentation lädt sie nie von selbst ein Modell herunter. Für eine geführte Einrichtung installierst du das llama.cpp-Plugin, führst openclaw onboard aus und wählst Managed local server für einen verwalteten lokalen Server. Vor dem Download siehst du das Modell, die Downloadgröße und das Backend. Bevor das Modell zum Standard wird, wird ein echter Tool-Aufruf getestet. Die kleinste Konfiguration braucht mindestens 8 GiB Arbeitsspeicher, größere brauchen mehr (OpenClaw-Dokumentation: Lokale Modelle). Dieselbe Seite nennt auch offen den Haken: Lokale Modelle haben nicht die Sicherheitsfilter von Modellen, die bei einem Anbieter laufen. Starte mit einem Modell bei einem Anbieter, bring eine echte Aufgabe zum Laufen und experimentiere danach.

Du möchtest eigens dafür einen Mac kaufen? Hier erfährst du, welche Mac-mini-Ausstattung OpenClaw wirklich braucht, für ein Cloud-Modell und für ein lokales Modell.

Wenn die Installation nicht klappt

  • Du weißt nicht, woran es liegt? Führe openclaw triage aus. Der Befehl prüft dein System, ohne etwas zu verändern, und erstellt eine übersichtliche Problembeschreibung. Er kann sie an Claude Code, Codex oder den eigenen Agenten von OpenClaw weitergeben. Laut Dokumentation verlässt nichts deinen Mac, bis du eine dieser Optionen auswählst.
  • „command not found: openclaw“: Schließe zuerst das Terminal und öffne ein neues Fenster. Wenn du die App nutzt, prüfe, ob sie aus „Programme“ läuft. Laut Dokumentation fügen Kopien, die aus „Downloads“, vom Schreibtisch oder aus einem Disk-Image gestartet werden, den Befehl openclaw nicht zu deiner Shell hinzu. Bei der Terminal-Installation liegt es fast immer an der PATH-Einstellung. Die Node.js-Seite der Dokumentation führt dich durch die Lösung.
  • Die Einrichtung der App klappt nicht: Wähle Retry setup, um sie erneut zu starten. Du kannst auch über das Symbol in der Menüleiste Connection… öffnen. Dort bietet die App Install, Update oder Repair Gateway an, um das Gateway zu installieren, zu aktualisieren oder zu reparieren. Meldet die App eine fehlende oder beschädigte Laufzeitumgebung, installiere OpenClaw.app neu.
  • Eine Berechtigungsabfrage erscheint nicht: Beende die App, entferne OpenClaw unter Systemeinstellungen > Datenschutz & Sicherheit und öffne es erneut aus „Programme“. Erteile die Berechtigung dann noch einmal. Laut Dokumentation erscheinen manche Berechtigungsabfragen erst nach einem vollständigen Neustart wieder.
  • Das Gateway startet ständig neu: Führe openclaw gateway status und openclaw doctor aus. Die Protokolldatei liegt unter ~/Library/Logs/openclaw/gateway.log.

Solltest du OpenClaw auf deinem Arbeits-Mac installieren?

Frag vorher nach. OpenClaw läuft im Hintergrund, ist über Chat-Apps erreichbar und kann Tools bekommen, die auf deinem Mac Aktionen ausführen. Der Sicherheitshinweis bei der Einrichtung sagt selbst: OpenClaw ist für eine einzelne vertrauenswürdige Person gedacht. Gemeinsam genutzte Installationen brauchen zusätzliche Absicherung. Bei einem Firmenlaptop solltest du das mit deinem IT-Team besprechen. Zum Kennenlernen ist ein privater Mac der einfachere Weg.

Du fragst dich, ob ein Desktop-Agent, der sich durch deine Apps klickt, besser zu deinem Büroalltag passt? Unser Ratgeber zum besten KI-Agenten für Desktop-Workflows vergleicht die Möglichkeiten. Du richtest OpenClaw auch auf einem PC ein? Hier erfährst du, wie du OpenClaw unter Windows installierst.

Kurze Antworten

Läuft OpenClaw auf einem älteren Mac?

Die Menüleisten-App braucht macOS 26.2 oder neuer. Die Terminal-Installation läuft auf Node. Dessen Mac-Versionen sind für macOS 13.5 und neuer ausgelegt. Auf älteren macOS-Versionen kann es funktionieren, sie werden aber nicht unterstützt.

Apple-Chip oder Intel?

Beides. Für beide gibt es eine eigene DMG-Datei. Wenn du nicht sicher bist, welchen Chip du hast, gibt es auch eine Universal-DMG.

Brauche ich Homebrew?

Nicht für die App. Das Terminal-Installationsskript nutzt Homebrew nur, wenn es für die Installation von Node oder Git gebraucht wird.

Ist OpenClaw kostenlos?

Die Software ist kostenlos und Open Source (MIT-Lizenz). Du bezahlst für das KI-Modell, das du verbindest. Das entfällt, wenn du ein lokales Modell auf deinem eigenen Mac betreibst.

Wie deinstalliere ich OpenClaw?

Prüfe zuerst mit openclaw uninstall --dry-run --all, was entfernt würde. Führe dann openclaw uninstall --all aus, um den Dienst, die Einstellungen, den Arbeitsordner und die App zu entfernen. Du möchtest die Dateien deines Agenten behalten? Führe nur openclaw uninstall aus und wähle aus, was entfernt werden soll. Falls du die App installiert hast, lösche sie auch aus „Programme“ (OpenClaw-Dokumentation: Deinstallation).

Prüfe deine macOS-Version, wähle deinen Installationsweg und sende deine erste Nachricht, bevor du heute Abend den Mac zuklappst.

Möchtest du die nächste Anleitung direkt in deinem Postfach?

No password needed – your reset opens instantly.

Kein Passwort. Nur deine E-Mail-Adresse, und du bist dabei.

OpenClaw soll den ganzen Tag laufen, auch ohne deinen Laptop? Hier erfährst du, wie du einen Mac mini für den OpenClaw-Dauerbetrieb einrichtest.

Quellen

🇬🇧 Read this page in English