OpenClaw Gateway auf macOS einrichten: Anleitung

Kennst du das Problem? Hintergrundprozesse, die unkontrolliert laufen oder abstürzen, sobald du das Hauptfenster einer App schließt. Auf macOS ist die saubere Verwaltung von Diensten oft komplizierter als sie sein müsste, besonders wenn man Entwicklungstools und GUIs kombinieren möchte.

OpenClaw geht hier einen sauberen Weg und trennt die App strikt vom Gateway-Prozess. Das sorgt für mehr Stabilität und gibt dir die volle Kontrolle über deine Umgebung.

Gateway auf macOS (externes launchd)

OpenClaw.app liefert Node/Bun oder die Gateway-Runtime nicht mehr im Bundle mit aus. Die macOS-App erwartet eine externe Installation der openclaw CLI. Sie startet das Gateway nicht als Child-Prozess, sondern verwaltet einen LaunchAgent pro Benutzer, um das Gateway aktiv zu halten (oder verbindet sich mit einem bereits laufenden lokalen Gateway).

CLI installieren (erforderlich für den lokalen Modus)

Node 24 ist die Standard-Runtime auf dem Mac. Node 22 LTS (aktuell 22.14+) funktioniert ebenfalls weiterhin. Installiere openclaw global mit diesem Befehl:

npm install -g openclaw@<version>

Der Button Install CLI in der macOS-App führt denselben Prozess über npm oder pnpm aus (Bun wird für die Gateway-Runtime nicht empfohlen).

Launchd (Gateway als LaunchAgent)

Label:

• ai.openclaw.gateway (oder ai.openclaw.<profile>; ältere com.openclaw.* Einträge könnten noch vorhanden sein)

Plist-Speicherort (pro Benutzer):

• ~/Library/LaunchAgents/ai.openclaw.gateway.plist (oder ~/Library/LaunchAgents/ai.openclaw.<profile>.plist)

Verwaltung:

• Die macOS-App übernimmt im Local-Modus die Installation und Aktualisierung des LaunchAgent.
• Du kannst ihn auch über die CLI installieren: openclaw gateway install.

Verhalten:

• Die Option „OpenClaw Active“ aktiviert oder deaktiviert den LaunchAgent.
• Wenn du die App beendest, wird das Gateway nicht gestoppt (launchd hält es am Leben).
• Falls bereits ein Gateway auf dem konfigurierten Port läuft, verbindet sich die App mit diesem, anstatt ein neues zu starten.
• Das sorgt für eine konsistente Verbindung ohne Prozess-Konflikte.

Logging:

• launchd stdout/err: /tmp/openclaw/openclaw-gateway.log

Versionskompatibilität

Die macOS-App prüft die Gateway-Version gegen ihre eigene Version. Wenn diese nicht kompatibel sind, solltest du die globale CLI aktualisieren, damit sie zur App-Version passt.

Smoke check

openclaw --version

OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback

Danach:

openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000

Nächste Schritte

• Gateway Konfiguration
• CLI Referenz

AI Setup Assistant