> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway-Lebenszyklus unter macOS

Die macOS-App **verwaltet das Gateway standardmäßig über launchd** und startet
das Gateway nicht als Kindprozess. Sie versucht zunächst, sich mit einem bereits laufenden
Gateway am konfigurierten Port zu verbinden; wenn keines erreichbar ist, aktiviert sie den launchd-
Dienst über die externe `openclaw`-CLI (keine eingebettete Runtime). Dadurch erhalten Sie
zuverlässigen Autostart bei der Anmeldung und Neustart bei Abstürzen.

Der Kindprozessmodus (Gateway wird direkt von der App gestartet) wird heute **nicht verwendet**.
Wenn Sie eine engere Kopplung an die UI benötigen, führen Sie das Gateway manuell in einem Terminal aus.

## Standardverhalten (launchd)

* Die App installiert einen benutzerspezifischen LaunchAgent mit dem Label `ai.openclaw.gateway`
  (oder `ai.openclaw.<profile>` bei Verwendung von `--profile`/`OPENCLAW_PROFILE`; das alte `com.openclaw.*` wird unterstützt).
* Wenn der lokale Modus aktiviert ist, stellt die App sicher, dass der LaunchAgent geladen ist, und
  startet das Gateway bei Bedarf.
* Logs werden in den launchd-Gateway-Logpfad geschrieben (sichtbar in den Debug-Einstellungen).

Häufige Befehle:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
launchctl bootout gui/$UID/ai.openclaw.gateway
```

Ersetzen Sie das Label durch `ai.openclaw.<profile>`, wenn Sie ein benanntes Profil ausführen.

## Nicht signierte Dev-Builds

`scripts/restart-mac.sh --no-sign` ist für schnelle lokale Builds gedacht, wenn Sie keine
Signaturschlüssel haben. Um zu verhindern, dass launchd auf eine nicht signierte Relay-Binärdatei zeigt, geschieht Folgendes:

* `~/.openclaw/disable-launchagent` wird geschrieben.

Signierte Ausführungen von `scripts/restart-mac.sh` entfernen diese Außerkraftsetzung, wenn die Markierung
vorhanden ist. Zum manuellen Zurücksetzen:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
rm ~/.openclaw/disable-launchagent
```

## Nur-Anhängen-Modus

Um die macOS-App zu zwingen, **launchd niemals zu installieren oder zu verwalten**, starten Sie sie mit
`--attach-only` (oder `--no-launchd`). Dadurch wird `~/.openclaw/disable-launchagent` gesetzt,
sodass die App sich nur mit einem bereits laufenden Gateway verbindet. Dasselbe
Verhalten können Sie in den Debug-Einstellungen umschalten.

## Remote-Modus

Der Remote-Modus startet niemals ein lokales Gateway. Die App verwendet einen SSH-Tunnel zum
Remote-Host und verbindet sich über diesen Tunnel.

## Warum wir launchd bevorzugen

* Autostart bei der Anmeldung.
* Integrierte Neustart-/KeepAlive-Semantik.
* Vorhersagbare Logs und Überwachung.

Wenn ein echter Kindprozessmodus jemals wieder benötigt wird, sollte er als
separater, expliziter reiner Dev-Modus dokumentiert werden.

## Verwandte Themen

* [macOS-App](/de/platforms/macos)
* [Gateway-Runbook](/de/gateway)