Skip to main content
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:
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:

​
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