Come installare OpenClaw su un Mac mini

Cos’è OpenClaw

OpenClaw è un assistente AI open source che gira sul tuo computer. Ci parli dalle app di chat che usi già. Il suo README elenca Discord, iMessage, Slack, Teams, Telegram e WhatsApp, più di 20 altre (github.com/openclaw/openclaw, ottobre 2026).

Il pezzo centrale è il Gateway. È un processo sempre in esecuzione che mantiene le connessioni alle chat ed esegue l’agente. Se il Gateway si ferma, l’assistente smette di rispondere. Per questo la macchina su cui gira conta più dell’installazione.

Requisiti

• Node 24.16 o successivo, oppure Node 26.1 o successivo. Su macOS, se Node manca, l’installer aggiunge Node 26 (docs.openclaw.ai/install, ottobre 2026).
• Un provider di modelli. OpenClaw prende una chiave API dal provider che scegli durante l’onboarding.
• Qualsiasi Mac Apple silicon. La documentazione non fissa un minimo di memoria. Con un modello in cloud, 16 GB sono più che sufficienti. Un modello locale è un’altra storia, spiegata nella nostra guida agli LLM locali.

Installalo

Esegui l’installer ufficiale nel Terminale.

curl -fsSL https://openclaw.ai/install.sh | bash

Quando finisce, ti porta direttamente all’onboarding. Se vuoi installare ora e configurare dopo, la documentazione indica un flag che salta l’onboarding. Poi esegui tu l’onboarding con l’opzione del servizio.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
openclaw onboard --install-daemon

Abbiamo eseguito l’installer su una macchina macOS 26 nuova in hosting su GitHub, il 2 ottobre 2026. Node era già presente, quindi ci sono voluti circa 25 secondi. Questo è ciò che ha stampato il controllo della versione.

$ openclaw --version
OpenClaw 2026.9.7 (c074824)

Poi verifica l’installazione e il servizio con i comandi documentati.

openclaw doctor
openclaw gateway status

Sulla nostra macchina di test, prima dell’onboarding doctor ha segnalato tre cose. La modalità del Gateway non era impostata. L’autenticazione del Gateway non aveva un token. E non c’era un owner dei comandi. Esegui di nuovo doctor dopo l’onboarding e sistema quello che resta. Prendi sul serio l’owner. Doctor lo descrive come l’account che può cambiare la configurazione, riavviare il Gateway e approvare i comandi.

Tienilo attivo 24/7

L’opzione del servizio installa un LaunchAgent. La documentazione indica l’etichetta ai.openclaw.gateway e il file ai.openclaw.gateway.plist nella cartella LaunchAgents della Library nella tua home. launchd lo avvia al login e lo riavvia se va in crash. I log finiscono in un unico file.

openclaw gateway status --deep
openclaw gateway restart
openclaw health
tail -f ~/Library/Logs/openclaw/gateway.log

Puoi anche installare solo il servizio, senza onboarding. L’abbiamo fatto su una seconda macchina di test. Abbiamo impostato la modalità del Gateway su local, lasciato che doctor generasse un token ed eseguito il comando di installazione.

openclaw config set gateway.mode local
openclaw doctor --fix --generate-gateway-token
openclaw gateway install

Circa 15 secondi dopo, il comando status mostrava il servizio attivo.

$ openclaw gateway status
Service file: ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Gateway: bind=loopback (127.0.0.1), port=18789 (service args)
Dashboard: http://127.0.0.1:18789/
Gateway version: 2026.9.7
Runtime: running (pid 16165, state active)
Connectivity probe: ok
Listening: 127.0.0.1:18789

Un LaunchAgent gira solo mentre un utente ha fatto il login. Dopo un riavvio non parte nulla finché qualcuno non fa il login. Su un Mac senza supervisione, attiva il login automatico per l’account che esegue OpenClaw. Poi impedisci lo stop della macchina, perché lo stop congela il Gateway e fa cadere ogni connessione alle chat.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

I motivi e le regole sul coperchio del portatile sono in cosa succede quando un Mac va in stop. La checklist completa, compresi i blackout, è nella guida al Mac sempre acceso.

Note di sicurezza

• In un’installazione normale il Gateway ascolta solo su loopback. Lascialo così. Per raggiungere la dashboard dal tuo portatile, la documentazione usa un tunnel SSH.
• I mittenti sconosciuti nei messaggi diretti ricevono un codice di abbinamento, non una risposta. Li approvi con il comando di pairing qui sotto.
• Di default gli strumenti girano sull’host, a meno che tu non configuri una sandbox. L’agente può toccare tutto ciò che può toccare quell’utente macOS.
• I segreti stanno su disco nella cartella di stato di OpenClaw, con la configurazione in openclaw.json dentro la stessa cartella. Trattala come un file di password.
• Esegui l’audit integrato dopo ogni modifica alla configurazione. Sulla nostra installazione di test appena fatta ha riportato 0 problemi critici, 1 avviso e 1 elemento informativo.

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
openclaw pairing approve <channel> <code>
openclaw security audit

La protezione più semplice è fisica. Esegui OpenClaw su un Mac che non contiene nient’altro di tuo. Niente Apple ID personale, niente password manager, niente browser pieno di login. Se l’agente fa qualcosa di strano, il danno si ferma a quella macchina.

Farlo girare su un Mac di MacRun

Il nostro piano Agent è un Mac mini dedicato che non va mai in stop. La sua sessione di login torna da sola dopo un riavvio, quindi i LaunchAgent ripartono. Arriva con Claude Code e Codex installati. OpenClaw non è preinstallato. Lo installi tu con i comandi qui sopra, perché hai pieni diritti di amministratore. OpenClaw ha bisogno di una chiave API del provider di modelli che scegli durante l’onboarding.

Chi non dovrebbe usarci per questo. MacRun è pensato per il lavoro di sviluppo, secondo la nostra policy di utilizzo accettabile. Un OpenClaw che scrive codice, controlla la CI o smista le issue va bene. Uno che gestisce la tua email personale e il calendario di famiglia no. Inoltre OpenClaw gira su Linux. Se da macOS non ti serve nulla, un piccolo server Linux costa meno di qualsiasi Mac.

Vuoi provarlo su una macchina che resta accesa? Confronta i piani nella pagina del Mac per agenti.