Gateway auf macOS (externer launchd)

OpenClaw.app bündelt nicht mehr Node/Bun oder die Gateway Runtime. Die macOS-App erwartet eine externe openclaw CLI-Installation, startet das Gateway nicht als Child-Prozess und verwaltet einen benutzerspezifischen launchd Service, um das Gateway am Laufen zu halten (oder verbindet sich mit einem bereits laufenden lokalen Gateway, falls vorhanden).

CLI installieren (erforderlich für lokalen Modus)

Du brauchst Node 22+ auf dem Mac und installierst dann openclaw global:

npm install -g openclaw@<version>

Der Install CLI Button der macOS-App führt denselben Ablauf über npm/pnpm aus (bun wird für die Gateway Runtime nicht empfohlen).

Launchd (Gateway als LaunchAgent)

Label:

  • bot.molt.gateway (oder bot.molt.<profile>; Legacy com.openclaw.* kann noch vorhanden sein)

Plist-Speicherort (benutzerspezifisch):

  • ~/Library/LaunchAgents/bot.molt.gateway.plist (oder ~/Library/LaunchAgents/bot.molt.<profile>.plist)

Verwaltung:

  • Die macOS-App verwaltet die LaunchAgent-Installation und -Updates im lokalen Modus.
  • Das CLI kann es auch installieren: openclaw gateway install.

Verhalten:

  • “OpenClaw Active” aktiviert/deaktiviert den LaunchAgent.
  • Das Beenden der App stoppt das Gateway nicht (launchd hält es am Laufen).
  • Wenn ein Gateway bereits auf dem konfigurierten Port läuft, verbindet sich die App damit, anstatt ein neues zu starten.

Logging:

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

Versionskompatibilität

Die macOS-App prüft die Gateway-Version gegen ihre eigene Version. Wenn sie inkompatibel sind, aktualisiere das globale CLI, damit es zur App-Version passt.

Smoke Check

openclaw --version

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

Dann:

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