1. Warum ein Mac-spezifischer OpenClaw-Leitfaden
OpenClaw läuft auf mehreren Plattformen, aber auf dem Mac (besonders Apple Silicon) unterscheiden sich Umgebungspfad, Homebrew- und npm-Global-Prefix, Gatekeeper und Berechtigungen sowie die Art, den Prozess im Hintergrund laufen zu lassen, von Linux/Windows. Viele scheitern an „command not found“, EACCES oder Port-belegt. Dieser Leitfaden bietet reproduzierbare Mac-Schritte und eine Fehlerbehebungs-Tabelle.
2. Mac-Umgebung vorbereiten (Xcode CLI, Homebrew, Node)
Schritt 1: Xcode Command Line Tools installieren: im Terminal xcode-select --install ausführen.
Schritt 2: Homebrew mit dem offiziellen One-Liner installieren. Bei Apple Silicon Homebrew in die PATH aufnehmen: echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile, danach source ~/.zprofile.
Schritt 3: Node.js 22+ installieren. Empfohlen: brew install nvm, Shell konfigurieren, dann nvm install 22 und nvm use 22. Oder brew install node@22 und brew link node@22 --force. Mit node -v und npm -v prüfen.
3. Installationsmethoden im Vergleich
| Methode | Befehl / Hinweis | Einsatzfall |
|---|---|---|
| npm global | npm install -g openclaw@latest | Bestehende Node-Umgebung, schneller Test |
| Offizielles Skript | curl -fsSL https://openclaw.ai/install.sh | bash | Abhängigkeiten und PATH in einem Schritt |
| Docker | Offizielles oder Community-OpenClaw-Image nutzen | Isolierte Umgebung |
4. Fünf-Schritte-Installation und Erstlauf
Schritt 1: Gewählte Installation ausführen (z. B. npm install -g openclaw@latest). Bei EACCES: permission denied npm-Global-Verzeichnis anpassen: sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}.
Schritt 2: CLI prüfen: in neuem Terminal openclaw --version ausführen. Bei „command not found“ sicherstellen, dass die PATH das globale npm-bin enthält (npm config get prefix + /bin).
Schritt 3: Init laut Doku (z. B. openclaw onboard) und API-Key setzen. Standard-Konsolen-Port oft 18789 oder 3000; in Firewall oder Security Group erlauben.
Schritt 4: Gateway/Service starten (z. B. openclaw gateway oder openclaw start). Port im Browser öffnen und Konsolen-Zugriff prüfen.
Schritt 5: Minimalen Test (eine Anfrage über Konsole oder CLI), danach bei Bedarf LaunchAgent oder Hintergrund-Dauerbetrieb einrichten.
5. Apple-Silicon-Hinweise
(1) Homebrew-Pfad: Bei Apple Silicon liegt Homebrew unter /opt/homebrew; /opt/homebrew/bin in die PATH aufnehmen. (2) Rosetta 2: Manche npm-Nativ-Module können Rosetta anfordern; bei Aufforderung installieren. (3) Gatekeeper: Wird eine Binärdatei blockiert: Systemeinstellungen → Datenschutz & Sicherheit → „Trotzdem öffnen“.
6. Mac-Fehlerbehebungs-Tabelle
| Symptom | Wahrscheinliche Ursache | Maßnahme |
|---|---|---|
| Command not found (openclaw / node) | PATH ohne Homebrew oder npm global bin | Pfad in ~/.zprofile oder ~/.bash_profile eintragen und source |
| EACCES | npm-Global-Verzeichnis gehört nicht dem aktuellen User | chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} |
| Port in Benutzung | Standard-Port belegt | Port in Config ändern oder Prozess mit lsof beenden |
| Konsole nicht erreichbar | Firewall oder Security Group | App in macOS-Firewall erlauben; bei Remote-Mac 18789/3000 öffnen |
| Prozess beendet sich bei zugeklapptem Deckel | Kein Dauerbetrieb | LaunchAgent oder nohup/screen; oder auf Remote-Mac 24/7 laufen lassen |
7. Fazit: OpenClaw 24/7 auf Remote-Mac
Wenn OpenClaw lokal läuft und Sie 24/7-Betrieb ohne eigene Maschine oder ohne Sleep/Deckel-Probleme wollen, deployen Sie auf einem Remote-Mac-Node. Gleiches macOS und gleiche Schritte wie oben, dediziert und stabil. Um lokalen Dauerbetrieb und Ops zu vermeiden, mieten Sie einen MACGPU-Remote-Mac und installieren OpenClaw dort – einmal einrichten, dauerhaft stabil.