macOS companion app

Ciclo di vita del Gateway su macOS

Per impostazione predefinita, l'app macOS gestisce il Gateway tramite launchd e non avvia il Gateway come processo figlio. Innanzitutto tenta di connettersi a un Gateway già in esecuzione sulla porta configurata; se non è raggiungibile, abilita il servizio launchd tramite la CLI esterna openclaw (senza runtime incorporato). Ciò garantisce un avvio automatico affidabile all'accesso e il riavvio in caso di arresto anomalo.

La modalità processo figlio (Gateway avviato direttamente dall'app) non è attualmente in uso. Se è necessaria un'integrazione più stretta con l'interfaccia utente, eseguire manualmente il Gateway in un terminale.

Comportamento predefinito (launchd)

L'app installa un LaunchAgent per utente con etichetta ai.openclaw.gateway (oppure ai.openclaw.<profile> quando si usa --profile/OPENCLAW_PROFILE).
Quando è abilitata la modalità locale, l'app verifica che il LaunchAgent sia caricato e, se necessario, avvia il Gateway.
I log vengono scritti nel percorso dei log del Gateway di launchd (visibile nelle impostazioni di debug).

Comandi comuni:

bash

launchctl kickstart -k gui/$UID/ai.openclaw.gatewaylaunchctl bootout gui/$UID/ai.openclaw.gateway

Quando si esegue un profilo denominato, sostituire l'etichetta con ai.openclaw.<profile>.

Build di sviluppo non firmate

scripts/restart-mac.sh --no-sign consente di creare rapidamente build locali senza chiavi di firma. Per impedire a launchd di puntare a un binario relay non firmato, scrive ~/.openclaw/disable-launchagent.

Le esecuzioni firmate di scripts/restart-mac.sh rimuovono questa sostituzione se il marcatore è presente. Per ripristinare manualmente:

bash

rm ~/.openclaw/disable-launchagent

Modalità di sola connessione

Per impedire all'app macOS di installare o gestire launchd, avviarla con --attach-only (oppure --no-launchd). Questa opzione imposta ~/.openclaw/disable-launchagent, pertanto l'app si connette soltanto a un Gateway già in esecuzione. È possibile attivare o disattivare lo stesso comportamento nelle impostazioni di debug.

Modalità remota

La modalità remota non avvia mai un Gateway locale. L'app utilizza un tunnel SSH verso l'host remoto e si connette tramite tale tunnel.

Perché preferiamo launchd

Avvio automatico all'accesso.
Semantica di riavvio/KeepAlive integrata.
Log e supervisione prevedibili.

Se in futuro fosse nuovamente necessaria una vera modalità processo figlio, dovrebbe essere documentata come modalità separata, esplicita e riservata allo sviluppo.

Contenuti correlati

Was this useful?