Platforms overview
app macOS
L'app macOS è il companion della barra dei menu di OpenClaw. Usala quando vuoi una
UI nativa nell'area di notifica, prompt di autorizzazione macOS, notifiche, WebChat, input vocale,
Canvas o strumenti del nodo ospitati su Mac come system.run.
Se ti servono solo la CLI e il Gateway, inizia da Guida introduttiva.
Download
Scarica le build dell'app macOS dalle release GitHub di OpenClaw. Quando una release include asset dell'app macOS, cerca:
OpenClaw-<version>.dmg(preferito)OpenClaw-<version>.zip
Alcune release includono solo asset CLI, prove o Windows. Se la release più recente non ha asset dell'app macOS, usa la release più recente che li include, oppure compila l' app dal sorgente con configurazione di sviluppo macOS.
Primo avvio
- Installa e avvia OpenClaw.app.
- Scegli Questo Mac per un Gateway locale, oppure connettiti a un Gateway remoto.
- Per la modalità locale, attendi mentre l'app installa il runtime e il Gateway nello spazio utente.
- Completa la configurazione del provider e la checklist delle autorizzazioni macOS.
- Invia il messaggio di test di onboarding.
Per il percorso di configurazione CLI/Gateway, usa Guida introduttiva. Per il ripristino delle autorizzazioni, usa autorizzazioni macOS.
Scegli una modalità Gateway
| Modalità | Usala quando | Pagina di dettaglio |
|---|---|---|
| Locale | Questo Mac deve eseguire il Gateway e mantenerlo attivo con launchd. | Gateway su macOS |
| Remota | Un altro host esegue il Gateway e questo Mac deve controllarlo via SSH, LAN o Tailnet. | Controllo remoto |
La modalità locale richiede una CLI openclaw installata. Su un Mac nuovo, l'app installa
automaticamente la CLI e il runtime corrispondenti prima di avviare la procedura guidata del Gateway.
Consulta Gateway su macOS per il ripristino manuale.
Cosa gestisce l'app
- Stato della barra dei menu, notifiche, integrità e WebChat.
- Prompt di autorizzazione macOS per schermo, microfono, voce, automazione e accessibilità.
- Strumenti del nodo locali come Canvas, acquisizione da fotocamera/schermo, notifiche e
system.run. - Prompt di approvazione Exec per comandi ospitati su Mac.
- Tunnel SSH in modalità remota o connessioni dirette al Gateway.
L'app non sostituisce il Gateway OpenClaw o la documentazione generale della CLI. La configurazione di base del Gateway, provider, plugin, canali, strumenti e sicurezza si trova nella relativa documentazione.
Pagine di dettaglio macOS
| Attività | Leggi |
|---|---|
| Installare o eseguire il debug del servizio CLI/Gateway | Gateway su macOS |
| Tenere lo stato fuori dalle cartelle sincronizzate con il cloud | Gateway su macOS |
| Eseguire il debug del rilevamento e della connettività dell'app | Gateway su macOS |
| Comprendere il comportamento di launchd | Ciclo di vita del Gateway |
| Risolvere problemi di autorizzazioni o firma/TCC | autorizzazioni macOS |
| Connettersi a un Gateway remoto | Controllo remoto |
| Leggere lo stato della barra dei menu e i controlli di integrità | Barra dei menu, Controlli di integrità |
| Usare l'interfaccia chat integrata | WebChat |
| Usare l'attivazione vocale o push-to-talk | Attivazione vocale |
| Usare Canvas e i deep link Canvas | Canvas |
| Ospitare PeekabooBridge per l'automazione UI | Bridge Peekaboo |
| Configurare le approvazioni dei comandi | Approvazioni Exec, dettagli avanzati |
| Ispezionare i comandi del nodo Mac e l'IPC dell'app | IPC macOS |
| Acquisire i log | logging macOS |
| Compilare dal sorgente | configurazione di sviluppo macOS |
