Come installare NanoClaw su un Mac mini

Cos’è NanoClaw

NanoClaw è un assistente AI open source che fai girare sul tuo computer. È scritto in TypeScript, con licenza MIT. Il suo README lo definisce un’alternativa leggera a OpenClaw (github.com/nanocoai/nanoclaw, letto il 2 ottobre 2026). L’ultima release era la 2.4.0, del 23 settembre 2026.

La grande differenza è l’isolamento. Ogni agente gira nel proprio container Linux. Può vedere solo le cartelle che gli monti. L’agente è costruito sul Claude Agent SDK di Anthropic. Lo raggiungi da app di chat come WhatsApp, Telegram, Discord, Slack, Teams o iMessage. Ogni canale si aggiunge con una propria skill di setup.

Requisiti

Vengono dalla documentazione di installazione di NanoClaw (docs.nanoclaw.dev).

• macOS o Linux, con almeno 4 GB di memoria. L’installer dà un avviso sotto i 3.700 MB.
• Git, per scaricare il codice. L’installer non lo aggiunge per te.
• Docker Desktop su macOS. Gli agenti girano in container Docker. Se manca, l’installer aggiunge Docker Desktop con Homebrew.
• Node 22 o successivo e pnpm 10 o successivo. Se mancano, l’installer li aggiunge entrambi.
• Claude Code sul Mac. NanoClaw lo usa per correggere i passaggi di setup falliti e per aggiungere canali.
• Una credenziale per il modello. Il setup offre Claude o Codex. Questa guida usa una chiave API di Anthropic, che Anthropic fattura in base all’uso.

Installalo

Per prima cosa verifica che Git ci sia. Se compare una riga che inizia con git version, c’è.

git --version

Poi esegui questi quattro comandi dalla guida rapida ufficiale, una riga alla volta.

cd ~
git clone https://github.com/nanocoai/nanoclaw.git
cd nanoclaw
bash nanoclaw.sh

Lo script controlla la macchina e installa quello che manca. Poi una procedura guidata fa qualche domanda. La documentazione suggerisce Standard setup, poi Fresh agent. Per tutto il processo prevede da 30 a 60 minuti.

• Immagine della sandbox. Fetch the hardened image richiede un account NanoClaw gratuito. Build it here non richiede un account e impiega diversi minuti.
• Servizio AI. Scegli Claude, poi Paste an Anthropic API key. Il setup conserva la chiave in un vault locale chiamato OneCLI. La chiave non entra mai nel container dell’agente.
• Servizio. Il setup avvia NanoClaw in background e invia un messaggio di prova per verificare che l’agente risponda.

Il setup offre anche login con abbonamento. Se pensi di usarne uno, controlla prima i termini del tuo provider sugli strumenti di terze parti.

Dopo il setup, invia un messaggio dalla cartella nanoclaw. Il testo tra virgolette è il tuo messaggio. Per rifare il controllo completo, usa il passaggio verify.

cd ~/nanoclaw
pnpm run chat "Help me plan one of those weekend ideas."
pnpm run setup -- --step verify

Non abbiamo ancora eseguito questa installazione sulla nostra macchina di test. I comandi qui sopra sono copiati dalla documentazione di NanoClaw del 2 ottobre 2026. Ricontrollali prima di iniziare.

Tienilo attivo 24/7

Il setup installa un LaunchAgent nella cartella LaunchAgents della Library nella tua home. Il suo nome è simile a com.nanoclaw-v2 più un breve codice per la tua copia. Ha RunAtLoad e KeepAlive impostati. Quindi parte al login e si riavvia se va in crash. Questi sono i comandi documentati.

# Find your label
launchctl list | grep nanoclaw

# Restart
launchctl kickstart -k gui/$(id -u)/com.nanoclaw-v2-<slug>

# Stop / start
launchctl unload ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist
launchctl load   ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist

# Logs (stdout and stderr go to files, not the system log)
tail -f logs/nanoclaw.log logs/nanoclaw.error.log

Anche Docker deve essere attivo. Se non lo è, nessun agente può partire. La documentazione per la risoluzione dei problemi dice di avviare Docker Desktop, verificare che docker info funzioni, poi riavviare NanoClaw. Nelle impostazioni di Docker Desktop, attiva l’opzione che lo avvia al login.

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 NanoClaw. Poi impedisci lo stop del Mac. Lo stop mette in pausa Docker e fa cadere ogni connessione alle chat.

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

I motivi 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

• Gli agenti vedono solo le cartelle che autorizzi. Il file della allowlist è mount-allowlist.json in ~/.config/nanoclaw, fuori dal checkout. In un’installazione nuova parte vuoto.
• Gli agenti non hanno mai la tua chiave API in chiaro. Le richieste in uscita passano dal vault, che aggiunge la chiave al momento della richiesta.
• Il setup invia dati diagnostici anonimi. Imposta NANOCLAW_NO_DIAGNOSTICS=1 per disattivarli.
• La documentazione ha una pagina di hardening per configurazioni più restrittive. Copre i limiti all’accesso di rete, chi può scrivere all’agente e quali comandi può eseguire.

I container aiutano, ma una macchina dedicata aiuta di più. Esegui NanoClaw su un Mac che non contiene nient’altro di tuo. Se l’agente fa qualcosa di strano, il danno si ferma a quella macchina. Per rimuoverlo in seguito, la documentazione indica un flag di disinstallazione. Aggiungi --dry-run per vedere in anteprima cosa rimuoverebbe.

bash nanoclaw.sh --uninstall

Farlo girare su un Mac di MacRun

Il nostro piano Agent è un Mac mini dedicato che non va mai in stop. Si trova nella nostra struttura privata nel New Jersey. La sua sessione di login torna da sola dopo un riavvio, quindi i LaunchAgent ripartono. Claude Code e Codex sono preinstallati, e questo copre il bisogno di Claude Code di NanoClaw. NanoClaw e Docker Desktop non sono preinstallati. Li installi tu, perché hai pieni diritti di amministratore.

L’M6 base ha 16 GB di memoria, ben sopra il minimo di 4 GB. Il piano Agent costa $169 al mese. MacRun non vende chiavi API. Usa una chiave API del tuo provider di modelli, che ti fattura l’uso secondo i suoi termini.

Quando non ti serve MacRun

Se hai già un Mac che resta acceso e con il login fatto, usa quello. I passaggi qui sopra sono gli stessi. NanoClaw gira anche su Linux con Docker Engine. Se da macOS non ti serve nulla, un piccolo server Linux costa meno di qualsiasi Mac.

Inoltre MacRun è pensato per il lavoro di sviluppo, secondo la nostra policy di utilizzo accettabile. Un NanoClaw che rivede codice, controlla la CI o scrive le note di rilascio va bene. Uno che gestisce la chat di famiglia no. Vuoi provarlo su una macchina che resta accesa? Vedi la pagina del Mac per agenti.