Gateway-Lifecycle auf macOS verwalten

Kennst du das? Du startest dein System und musst erst einmal mühsam alle Hintergrunddienste von Hand hochfahren. Wenn dann noch ein Prozess im Hintergrund abstürzt, ohne dass du es merkst, ist die Fehlersuche vorprogrammiert. Wir wollen, dass dein Gateway einfach läuft, ohne dass du dich ständig darum kümmern musst.

Statt den Gateway als Child-process zu starten, setzt die macOS App auf eine saubere Trennung. Das sorgt für Zuverlässigkeit und ein System, das sich selbst heilt, wenn mal etwas schiefgeht.

Voraussetzungen

• macOS App
• openclaw CLI
• SSH (für den Remote mode)
• Administrator-Rechte für launchctl

Schnellstart

Die App verwaltet den Gateway standardmäßig über launchd. Sie versucht zuerst, sich an einen laufenden Gateway auf dem konfigurierten Port anzuhängen. Findet sie keinen, aktiviert sie den Dienst über die openclaw CLI.

1. Aktiviere den Local mode in der App.
2. Die App installiert einen LaunchAgent unter dem Label bot.molt.gateway.
3. Prüfe die Logs direkt in den Debug Settings.
4. Verwalte den Prozess bei Bedarf manuell über das Terminal:

# Gateway neu starten
launchctl kickstart -k gui/$UID/bot.molt.gateway

# Gateway stoppen
launchctl bootout gui/$UID/bot.molt.gateway

Wenn du ein bestimmtes Profil mit --profile oder OPENCLAW_PROFILE nutzt, ersetzt du das Label einfach durch bot.molt.<profile>.

Fehlerbehebung

Unsigned dev builds blockieren launchd Wenn du scripts/restart-mac.sh --no-sign für schnelle lokale Builds nutzt, wird eine Datei namens ~/.openclaw/disable-launchagent erstellt. Das verhindert, dass launchd auf ein nicht signiertes Relay-Binary zeigt. Um das manuell zurückzusetzen, lösche die Datei:

rm ~/.openclaw/disable-launchagent

Gateway soll nicht automatisch starten Falls du die Kontrolle behalten und nicht willst, dass die App launchd verwaltet, starte sie mit dem Flag --attach-only oder --no-launchd. Die App verbindet sich dann nur noch mit einem Gateway, den du selbst gestartet hast. Du kannst diesen Modus auch in den Debug Settings umschalten.

Warum wir launchd empfehlen

Wir setzen auf launchd, weil es die stabilste Lösung für macOS ist. Hier sind die wichtigsten Gründe:

• Automatischer Start direkt beim Login.
• Integrierte KeepAlive-Logik bei Abstürzen.
• Vorhersehbare Pfade für Logs und Überwachung.
• Saubere Trennung von UI und Hintergrundprozess.

AI Setup Assistant

Nächste Schritte

• Remote mode und SSH-Tunnel
• Debug Settings verwenden