Hoppa till huvudinnehåll

​
Gateway‑livscykel på macOS

MacOS-appen hanterar Gateway via launchd som standard och spawnar inte Gateway som en underordnad process. Den försöker först ansluta till en redan körande Gateway på den konfigurerade porten; om ingen är nåbar, det aktiverar launchd -tjänsten via den externa openclaw CLI (ingen inbäddad runtime). Detta ger dig pålitliga autostart vid inloggning och omstart vid krascher. Child‐processläge (Gateway spawnas direkt av appen) används **inte idag. Om du behöver en hårdare koppling till användargränssnittet, kör Gateway manuellt i en terminal.

​
Standardbeteende (launchd)

  • Appen installerar en LaunchAgent märkt bot.molt.gateway (eller bot.molt.<profile> vid användning av --profile/OPENCLAW_PROFILE; äldre com.openclaw.* stöds).
  • När Lokalt läge är aktiverat ser appen till att LaunchAgent är laddad och startar Gateway vid behov.
  • Loggar skrivs till launchd‑gatewayns loggsökväg (synlig i Felsökningsinställningar).
Vanliga kommandon: 
launchctl kickstart -k gui/$UID/bot.molt.gateway
launchctl bootout gui/$UID/bot.molt.gateway
Ersätt etiketten med bot.molt.<profile> när du kör en namngiven profil.

​
Osignerade dev‑byggen

scripts/restart-mac.sh --no-sign är för snabba lokala kompileringar när du inte har signeringsnycklar. För att förhindra launchd från att peka på ett osignerat relä binärt, den:
  • Skriver ~/.openclaw/disable-launchagent.
Signerade körningar av scripts/restart-mac.sh rensa denna åsidosättning om markören är närvarande. Återställning manuellt: 
rm ~/.openclaw/disable-launchagent

​
Endast‑anslutningsläge

För att tvinga macOS appen att aldrig installera eller hantera launchd, starta den med --attach-only (eller --no-launchd). Detta sätter ~/.openclaw/disable-launchagent, så att appen bara fäster till en redan körande Gateway. Du kan växla mellan samma beteende i Debug Settings.

​
Fjärrläge

Fjärrläge startar aldrig en lokal Gateway. Appen använder en SSH-tunnel till fjärrvärd och ansluter över den tunneln.

​
Varför vi föredrar launchd

  • Autostart vid inloggning.
  • Inbyggd omstart/KeepAlive‑semantik.
  • Förutsägbara loggar och övervakning.
Om ett äkta barnprocess‑läge någon gång behövs igen bör det dokumenteras som ett separat, uttryckligt läge endast för utveckling.