OpenClaw può essere installato su Mac in diversi modi, a seconda di come preferisci lavorare e gestire la configurazione. In questa guida trovi istruzioni passo passo per i vari metodi di installazione, insieme a suggerimenti per avviare OpenClaw senza intoppi.
Panoramica rapida: tre modi per installare OpenClaw su Mac
Ecco un confronto affiancato dei tre metodi. Cambia, per ciascuno, la quantità di configurazione manuale richiesta.
| Programma di installazione a riga unica | Homebrew | Kimi Claw (online) | |
|---|---|---|---|
| Che cos’è | Script di installazione ufficiale che scarica e configura automaticamente OpenClaw | Configurazione manuale con Homebrew per installare le dipendenze (come Node.js), quindi esecuzione di OpenClaw tramite CLI | Strumento online che permette di eseguire OpenClaw nel cloud senza configurazione manuale |
| Passaggi manuali richiesti | Passaggi manuali minimi | Sono richiesti più passaggi manuali | Nessuna configurazione manuale richiesta |
| Codice o terminale richiesti | Sì | Sì | No |
| Disponibilità 24/7 | Funziona solo mentre il Mac è attivo | Funziona solo mentre il Mac è attivo | Funziona nel cloud 24/7 |
| Ideale per | Utenti alle prime armi che vogliono la configurazione locale più rapida | Sviluppatori che preferiscono gestire i pacchetti con Homebrew | Utenti che vogliono eseguire OpenClaw senza configurazione locale |
Kimi Claw ti consente di eseguire OpenClaw nel cloud senza configurare Node.js, Homebrew o chiavi API. In pochi minuti puoi iniziare a usare un agent funzionante direttamente nel browser.
Se preferisci una configurazione locale, passa alla sezione successiva. Se vuoi un’opzione più semplice, vai alla sezione Eseguire OpenClaw su Mac con Kimi Claw oppure fai clic sul pulsante qui sotto per iniziare subito.
Prima di iniziare: preparazione essenziale e sicurezza
Prima di installare OpenClaw in locale su Mac, completa alcuni passaggi di preparazione e sicurezza. Se prevedi di usare Kimi Claw, puoi saltare questa sezione e passare direttamente alle istruzioni di configurazione qui sotto.
Dipendenze: il programma di installazione a riga unica installa automaticamente Node.js, se necessario. Se scegli Homebrew, devi installare Node.js manualmente (Node 24 consigliato; funziona anche Node 22 LTS 22.16+).
Firewall e impostazioni di rete: il firewall di macOS è in genere disattivato per impostazione predefinita. Puoi abilitarlo in Impostazioni di Sistema > Rete > Firewall. OpenClaw associa il gateway a 127.0.0.1 (localhost), quindi gli altri dispositivi della rete non possono connettersi direttamente. Se ti serve accesso da mobile o da remoto, puoi usare strumenti come Tailscale o un tunnel SSH. Non inoltrare la porta
18789tramite il router.
Installare OpenClaw su Mac con lo script a riga unica
Questo è il modo più rapido per eseguire OpenClaw in locale su Mac. OpenClaw si esegue dal Terminale e offre un’interfaccia basata su browser per gestire il tuo agent, invece di una tradizionale app grafica. Un solo comando installa la CLI, verifica la versione di Node.js e avvia la procedura guidata di onboarding.
Passaggio 1. Esegui lo script di installazione nel Terminale
Apri Terminale con Spotlight (⌘ + Space), quindi incolla il comando seguente:
Lo script rileva il sistema, installa la CLI di OpenClaw e controlla la versione di Node.js. Se Node.js manca o è obsoleto, installa automaticamente Node 24 (è supportato anche Node 22 LTS 22.16+).
Passaggio 2. Imposta la chiave API e configura il gateway
La procedura guidata di onboarding parte automaticamente al termine dell’installazione. Seleziona Moonshot AI (Kimi K2.5) come provider LLM e incolla la tua chiave Kimi API quando richiesto. Accetta le impostazioni predefinite per la porta del gateway e l’autenticazione. Se vuoi che OpenClaw si avvii automaticamente all’accensione del Mac, scegli l’opzione di installazione del daemon durante l’onboarding.
Passaggio 3. Verifica il gateway e apri la dashboard
Esegui il comando seguente per verificare che il gateway sia in esecuzione:
Poi apri la dashboard:
Questo comando apre la Control UI nel browser all’indirizzo http://127.0.0.1:18789. Inserisci il token del gateway per accedere. Una volta effettuato l’accesso, puoi iniziare a interagire con il tuo agent OpenClaw.
Installare OpenClaw su Mac con Homebrew
Se preferisci gestire i pacchetti con Homebrew, puoi installare OpenClaw su Mac con una configurazione più manuale. Questo metodo ti offre maggiore controllo sulle dipendenze e si integra nel tuo flusso di lavoro Homebrew abituale.
Passaggio 1. Installa Homebrew
Apri Terminale con Spotlight (⌘ + Space). Se Homebrew non è installato, esegui il comando seguente. Homebrew è un gestore di pacchetti per macOS che consente di installare e gestire strumenti per sviluppatori dal Terminale, in modo simile a un app store per le app.
Durante l’installazione potrebbe esserti chiesto di inserire la password di accesso del Mac. Tieni presente che, per motivi di sicurezza, Terminale non mostrerà alcun carattere mentre digiti. Potresti vedere anche richieste di conferma dell’installazione e messaggi che indicano i file in corso di installazione.
Al termine dell’installazione vedrai in Terminale un messaggio di conferma e i passaggi successivi.
Passaggio 2. Installa Node.js
Una volta installato Homebrew, installa Node.js:
Dopo l’installazione, verifica che la versione sia v24 (consigliata) o v22.16+.
Passaggio 3. Installa la CLI di OpenClaw ed esegui l’onboarding
Installa la CLI globalmente con npm, quindi avvia l’onboarding:
Se durante npm install -g compare un errore di autorizzazione EACCES, la directory globale di npm richiede privilegi elevati. Esegui sudo npm install -g openclaw@latest oppure cambia la directory predefinita di npm per evitare di usare sudo in futuro.
Il flag --install-daemon registra OpenClaw come LaunchAgent, così il gateway si avvia automaticamente al login. Durante l’onboarding, seleziona Moonshot AI (Kimi K2.5) come provider e inserisci la tua chiave Kimi API.
Passaggio 4. Controlla il gateway e apri la dashboard
Verifica che il gateway sia in esecuzione e apri la dashboard:
La Control UI si apre nel browser. Inserisci il token del gateway e sei pronto per iniziare.
Eseguire OpenClaw su Mac con Kimi Claw
Kimi Claw è uno strumento online che consente di eseguire OpenClaw nel cloud senza configurazione locale. Non devi installare nulla sul Mac, né usare il Terminale o gestire dipendenze. Tutto funziona nel browser. Puoi creare un agent OpenClaw in pochi minuti. Kimi Claw gestisce gateway, workspace, archiviazione e accesso al modello, così il tuo agent resta online 24/7 anche quando il MacBook è chiuso.
Come si usa Kimi Claw?
Passaggio 1. Apri Kimi Claw
Vai alla pagina di Kimi Claw e fai clic su Crea per avviare il deployment del tuo ambiente OpenClaw.
Passaggio 2. Distribuisci OpenClaw automaticamente
Conferma il deployment nella finestra pop-up. Kimi Claw configura quindi l’ambiente OpenClaw, inclusi gateway, workspace e strumenti. Di solito la procedura si completa in pochi minuti.
Passaggio 3. Inizia a usare OpenClaw
Al termine del deployment, il tuo workspace si apre nella dashboard. Inizia a chattare con il tuo agent, configura le skill, pianifica attività e gestisci file, tutto dal browser.
In cosa Kimi Claw è diverso dall’esecuzione locale di OpenClaw
Kimi Claw offre un modo più semplice per eseguire OpenClaw senza configurazione locale. Invece di installare dipendenze e gestire un ambiente locale, puoi eseguire il tuo agent direttamente nel browser, mentre Kimi Claw si occupa della configurazione e dell’infrastruttura sottostanti.
Nessuna configurazione locale richiesta: esegui OpenClaw senza installare Node.js né usare il Terminale. Tutto funziona direttamente nel browser, così puoi iniziare più rapidamente ed evitare problemi di configurazione dell’ambiente.
Accesso immediato a oltre 5.000 skill: invece di installare manualmente gli strumenti, Kimi Claw può usare automaticamente le skill necessarie per la tua attività attingendo a un’ampia libreria di strumenti disponibili, riducendo tempi di configurazione e problemi di compatibilità.
Automazione e pianificazione sempre attive: a differenza degli agent locali, che si fermano quando il Mac va in stop, Kimi Claw funziona nel cloud 24/7 ed è quindi adatto ad attività pianificate e workflow di lunga durata.
40GB di archiviazione cloud e memoria persistente: a differenza delle configurazioni locali, in cui i file sono in genere legati a un solo dispositivo, Kimi Claw include 40GB di archiviazione, rendendo report e ricerche accessibili da qualsiasi browser. Ricorda inoltre preferenze e contesto di lavoro tra una sessione e l’altra, così puoi riprendere da dove avevi interrotto.
Modello Kimi K2.5 integrato e ricerca di livello professionale: Kimi Claw include l’accesso integrato a Kimi K2.5 e funzionalità di ricerca avanzate, quindi non devi gestire chiavi API né configurare servizi esterni. Può importare automaticamente informazioni aggiornate in ambiti come finanza, tecnologia e notizie, rendendo più fluide la ricerca e l’esecuzione delle attività.
Mantenere OpenClaw in esecuzione 24/7 su Mac
La maggior parte degli utenti tratta l’AI come una tradizionale app desktop: la usa mentre è alla scrivania e la chiude quando ha finito. Per automazioni davvero utili, come monitorare i mercati globali durante la notte o ricevere un report di ricerca nella posta in arrivo entro le 8 del mattino, il tuo agent deve restare attivo 24 ore su 24. Poiché macOS sospende naturalmente i processi locali quando il sistema va in stop, serve una strategia specifica. Questa sezione illustra due modi per mantenere una connessione persistente:
Opzione A: hardware Mac dedicato
Una possibilità è mantenere un Mac (ad esempio un Mac mini) sempre in esecuzione. Puoi disattivare lo stop con sudo pmset -a sleep 0 e abilitare “Riattiva per l’accesso alla rete” in Impostazioni di Sistema. Per l’accesso da remoto puoi usare strumenti come Tailscale o un tunnel SSH.
Questa configurazione mantiene OpenClaw in esecuzione sul tuo hardware, ma richiede di tenere il computer acceso e di occuparti personalmente di manutenzione, aggiornamenti e riavvii.
Opzione B: Kimi Claw se ne occupa automaticamente
Se esegui il tuo agent con Kimi Claw, la disponibilità 24/7 è inclusa. L’agent funziona indipendentemente dal dispositivo locale, quindi continua a lavorare anche quando il Mac è chiuso o offline. Non devi modificare le impostazioni di stop né tenere una macchina sempre accesa.
Correggere gli errori comuni di installazione di OpenClaw su Mac
Anche con una configurazione semplice, durante l’installazione possono verificarsi problemi. Ecco quelli più comuni e come risolverli.
Errore comando OpenClaw non trovato
Causa: la directory globale dei binari di npm non è nel PATH della tua shell.
Soluzione: esegui
source ~/.zshrcper ricaricare la configurazione della shell. Se usi Bash invece di Zsh, sostituisci~/.zshrccon~/.bash_profile. Se l’errore persiste, individua il prefisso di npm e aggiungilo al PATH:
OpenClaw non si avvia dopo il riavvio
Causa: il LaunchAgent non è stato installato durante l’onboarding.
Soluzione: esegui il comando di onboarding con il flag daemon:
Questo registra un LaunchAgent che avvia automaticamente il gateway di OpenClaw al login. Per verificare che sia attivo:
La porta 18789 è già in uso
Causa: un altro processo sta occupando la porta del gateway.
Soluzione: individua e interrompi il processo in conflitto:
Errore degli Xcode Command Line Tools durante l’installazione delle skill
Causa: alcuni pacchetti npm richiedono compilazione nativa e gli Xcode Command Line Tools sono mancanti o obsoleti.
Soluzione: installa o aggiorna gli strumenti:
Al termine dell’installazione, riprova a installare la skill.
Versione di Node.js troppo vecchia
Causa: sul Mac è installata una versione di Node.js precedente alla 22.16. OpenClaw richiede Node 24 (consigliato) o Node 22 LTS 22.16+.
Soluzione: se hai usato Homebrew:
Se hai usato lo script a riga unica, eseguilo di nuovo. Lo script rileverà la versione obsoleta e la aggiornerà.
Conclusione
OpenClaw può essere eseguito in locale sul Mac con lo script a riga unica o Homebrew, oppure nel browser con Kimi Claw senza configurazione locale. Ogni metodo porta a un agent funzionante, ma richiede un diverso livello di intervento manuale. Se vuoi una configurazione più rapida con disponibilità 24/7 integrata, puoi iniziare da Kimi Claw e avere il tuo agent operativo in pochi minuti.
Domande frequenti
openclaw onboard --install-daemon per registrare un LaunchAgent che avvii il gateway al login. Se il daemon è già installato ma non parte, verificane lo stato con launchctl list | grep openclaw e consulta i log di sistema. Gli utenti Kimi Claw non hanno bisogno di questa configurazione, perché il servizio gira su server cloud e resta online in autonomia.source ~/.zshrc per ricaricare la configurazione. Se il comando non viene ancora trovato, esegui npm config get prefix per individuare la directory bin e aggiungerla al PATH in ~/.zshrc. Riavvia Terminale dopo aver apportato la modifica.sudo pmset -a sleep 0) e accesso remoto tramite Tailscale, oppure usare Kimi Claw. Kimi Claw è una piattaforma completamente gestita che mantiene il tuo agent OpenClaw online 24 ore su 24, senza hardware da gestire.curl -fsSL https://openclaw.ai/install.sh | bash. Lo script installa OpenClaw, verifica la versione di Node.js e ti guida nella configurazione. Puoi usare anche Homebrew: esegui brew install node, quindi npm install -g openclaw@latest. Se preferisci un’opzione completamente gestita che non richiede Terminale, Kimi Claw esegue OpenClaw nel browser, senza configurazione locale.curl -fsSL https://openclaw.ai/install.sh | bash) oppure installa tramite Homebrew con npm install -g openclaw@latest. Se vuoi un’opzione basata su browser che non richiede download, Kimi Claw esegue OpenClaw per te su server cloud.