system.run.
Servono solo la CLI e il Gateway? Iniziare da Guida introduttiva.
Download
Scaricare le build dell’app macOS dalle release di OpenClaw su GitHub. Quando una release include risorse dell’app macOS, cercare:OpenClaw-<version>.dmg(opzione preferita)OpenClaw-<version>.zip
Primo avvio
- Installare e avviare OpenClaw.app.
- Scegliere This Mac per un Gateway locale oppure connettersi a un Gateway remoto.
- Attendere che l’app installi il runtime CLI corrispondente. In modalità locale, installa e avvia anche il Gateway.
- Stabilire l’inferenza mediante un controllo con un modello attivo. Una volta superato, OpenClaw gestisce il resto della configurazione.
- Completare l’elenco delle autorizzazioni di macOS e inviare il messaggio di prova dell’onboarding.
Aggiornamenti
La scheda di aggiornamento della dashboard indica cosa verrà aggiornato dall’app:- Aggiorna app Mac + Gateway significa che l’app firmata gestisce il Gateway locale tramite launchd. Sparkle aggiorna prima l’app; dopo il riavvio, l’app aggiorna e riavvia automaticamente il proprio Gateway alla versione corrispondente, quindi verifica la connessione.
- Aggiorna Gateway significa che l’app è connessa a un Gateway remoto, a un Gateway locale gestito manualmente o a un’altra installazione non gestita dall’app. Il pulsante esegue il normale flusso di aggiornamento di quel Gateway anziché modificare l’app Mac.
extended-stable.
Dopo un aggiornamento riuscito, l’app individua la sessione diretta di primo livello
utilizzata più di recente da una persona e invia a tale agente un evento di aggiornamento una tantum. Le attività di Heartbeat
e Cron non influiscono su questa scelta. L’agente può quindi dare nuovamente il benvenuto
dalla conversazione utilizzata con maggiore probabilità. In modalità remota, l’app
aggiorna solo il runtime Node locale del Mac e omette la notifica quando il
Gateway remoto è meno recente dell’app.
Sparkle segue l’impostazione update.channel del Gateway. beta e dev consentono di ricevere
le build beta dell’app; stable, extended-stable e i valori mancanti o sconosciuti
mantengono le build stabili dell’app.
Apertura dei link della dashboard
Nella dashboard incorporata dell’app macOS, facendo clic su un link web esterno, questo si apre in una barra laterale del browser ridimensionabile, larga metà della finestra, mentre la navigazione della dashboard rimane visibile. Trascinare il divisore per scegliere un’altra larghezza; l’app la memorizza. Ogni link si apre in una scheda distinta, la barra delle schede appare quando sono aperte più pagine e facendo nuovamente clic sullo stesso link viene riutilizzata la scheda esistente. Trascinare le schede per riordinarle, chiuderle con il pulsante di chiusura della scheda o con un clic centrale e fare clic con il pulsante destro del mouse su una scheda per accedere a Open in Default Browser, Copy Link, Reload, Close Tab e Close Other Tabs. I controlli Indietro/Avanti nella barra del titolo della finestra e i gesti di scorrimento sul trackpad consentono di navigare nella cronologia della dashboard; i controlli Indietro/Avanti della barra laterale consentono di navigare nella cronologia della scheda attiva. La barra laterale dispone inoltre dei controlli per ricaricare, aprire nel browser predefinito e chiudere. I controlli della barra del titolo seguono la barra laterale dell’app: quando è espansa, i controlli Indietro/Avanti si trovano sul suo bordo destro accanto al pulsante della barra laterale; quando è compressa, lasciano spazio a un pulsante di ricerca, che apre la tavolozza dei comandi, e a un pulsante per una nuova sessione. Fare clic con il pulsante destro del mouse su un link esterno per scegliere Open in Sidebar, Open in Default Browser o Copy Link. I clic con tasti modificatori e i link per nuove finestre attivati dall’utente nella dashboard continuano ad aprirsi nel browser predefinito; i link per nuove finestre all’interno della barra laterale si aprono come nuove schede della barra laterale. Le normali pagine dell’interfaccia di controllo ospitate nel browser mantengono il normale comportamento del browser per i link e il menu contestuale.Importazione degli accessi dal browser
La prima volta che si apre la barra laterale del browser mentre l’app utilizza un Gateway locale, la dashboard mostra un banner ignorabile se sul Mac esiste un profilo basato su Chrome contenente cookie. Il banner consente di copiare tali cookie in un profilo gestito e isolato, utilizzato dagli agenti per la navigazione. Scegliere un profilo dal controllo Import; potrebbe essere richiesto Touch ID. L’avanzamento e il numero di cookie importati vengono visualizzati direttamente nel banner e vengono copiati solo i cookie: le password non lasciano mai il browser di origine. La chiusura del banner registra la scelta; Settings → General → Browser login → Import… consente di riproporlo in qualsiasi momento. Consultare Browser per il flusso di importazione sottostante e il vincolobrowser.allowSystemProfileImport.
Scelta della modalità Gateway
Entrambe le modalità richiedono una CLI
openclaw installata, poiché l’app ne riutilizza il runtime
host del Node. Su un Mac appena configurato, l’app installa automaticamente la CLI corrispondente; la modalità
locale avvia quindi la procedura guidata del Gateway, mentre la modalità remota si connette al Gateway
selezionato senza avviare un secondo Gateway locale.
Per il ripristino manuale, consultare Gateway su macOS.
Componenti gestiti dall’app
- Stato della barra dei menu, notifiche, integrità e WebChat.
- Richieste di autorizzazione di macOS per schermo, microfono, riconoscimento vocale, automazione e accessibilità.
- Un Node Mac che combina Canvas nativo, acquisizione da fotocamera/schermo, notifiche, posizione e controllo del computer con i comandi di sistema, browser, plugin, skill e MCP dell’host Node della CLI.
- Richieste di approvazione dell’esecuzione per i comandi ospitati sul Mac.
- Esecuzione nel contesto dell’app per i comandi shell approvati, preservando l’attribuzione delle autorizzazioni macOS dell’app mentre il runtime CLI gestisce i criteri condivisi del Node.
- Tunnel SSH in modalità remota o connessioni dirette al Gateway.