nanoclaw v2.2.0

NanoClaw

Un assistente AI che esegue gli agenti in modo sicuro nei propri container. Leggero, progettato per essere facilmente comprensibile e completamente personalizzabile in base alle tue esigenze.

nanoclaw.dev • docs • 中文 • 日本語 • 한국어 • •

Agenti in Slack: un'app per agente

La configurazione fornisce a ogni agente la propria app Slack: manifest, avatar e installazione nel workspace, senza token da incollare. Crea compagni di squadra dalla chat: ognuno ottiene la propria identità bot, container e memoria, con stanze e canvas condivisi.

Perché ho creato NanoClaw

OpenClaw è un progetto impressionante, ma non avrei potuto dormire sonni tranquilli se avessi dato a un software complesso che non capivo pieno accesso alla mia vita. OpenClaw ha quasi mezzo milione di righe di codice, 53 file di configurazione e oltre 70 dipendenze. La sua sicurezza è a livello applicativo (allowlist, codici di abbinamento) piuttosto che una vera isolamento a livello di sistema operativo. Tutto gira in un unico processo Node con memoria condivisa.

NanoClaw fornisce la stessa funzionalità principale, ma in una codebase abbastanza piccola da essere compresa: un processo e una manciata di file. Gli agenti girano nei propri container Linux con isolamento del filesystem, non semplicemente dietro controlli di permessi.

Avvio rapido

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

nanoclaw.sh ti accompagna da una macchina appena avviata a un agente con un nome a cui puoi inviare messaggi. Installa Node, pnpm e Docker se mancanti, installa un gateway per le credenziali e vi registra la tua credenziale Anthropic, costruisce il container dell'agente e abbina il tuo primo canale (Slack, Telegram, Discord, WhatsApp, iMessage o una CLI locale). Se un passaggio fallisce, Claude Code viene invocato automaticamente per diagnosticare e riprendere da dove si è interrotto.

Migrazione da NanoClaw v1?

Esegui da un checkout v2 pulito accanto alla tua installazione v1:

git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash migrate-v2.sh

migrate-v2.sh trova la tua installazione v1 (directory adiacente, o NANOCLAW_V1_PATH=/path/to/nanoclaw), migra lo stato nel checkout v2, poi fa exec in Claude Code per completare le parti che richiedono giudizio (seeding del proprietario, migrazione della memoria condivisa, replay delle personalizzazioni del fork).

Esegui lo script direttamente, non dall'interno di una sessione Claude — la parte deterministica richiede prompt interattivi e I/O shell reale per il bootstrap di Node/pnpm, Docker, il gateway delle credenziali e la build del container.

Cosa fa: unisce .env, popola il DB v2 da registered_groups, copia le cartelle dei gruppi + i dati di sessione + le attività pianificate, installa gli adattatori di canale che selezioni, copia lo stato di autenticazione dei canali (incluso il keystore Baileys per WhatsApp — la mappatura LID ora è risolta per-messaggio dall'adattatore Baileys v7, non migrata), costruisce il container dell'agente.

Cosa non fa: non commuta il servizio di sistema. Scegli "switch to v2" al prompt, oppure fallo manualmente dopo i test — la tua installazione v1 rimane intatta.

Vedi docs/v1-to-v2-changes.md per le differenze e docs/migration-dev.md per le note di sviluppo.

Filosofia

Abbastanza piccolo da essere compreso. Un processo, pochi file sorgente e nessun microservizio. Se vuoi capire l'intera codebase di NanoClaw, chiedi semplicemente a Claude Code di guidarti attraverso di essa.

Sicuro tramite isolamento. Gli agenti girano in container Linux e possono vedere solo ciò che è esplicitamente montato. L'accesso a Bash è sicuro perché i comandi girano dentro il container, non sul tuo host.

Progettato per il singolo utente. NanoClaw non è un framework monolitico; è un software che si adatta alle esigenze esatte di ogni utente. Invece di diventare bloatware, NanoClaw è progettato per essere su misura. Crea il tuo fork e fai modificare a Claude Code per soddisfare le tue esigenze.

Personalizzazione = modifiche al codice. Nessuna proliferazione di configurazioni. Vuoi un comportamento diverso? Modifica il codice. La codebase è abbastanza piccola da rendere sicuro apportare modifiche.

AI-native, ibrido per design. Il flusso di installazione e onboarding è un percorso scriptato ottimizzato, veloce e deterministico. Quando un passaggio richiede giudizio, che si tratti di un'installazione fallita, una decisione guidata o una personalizzazione, il controllo passa senza soluzione di continuità a Claude Code. Oltre alla configurazione non c'è nemmeno una dashboard di monitoraggio o un'interfaccia di debug: descrivi il problema in chat e Claude Code se ne occupa.

Skill invece di funzionalità. Il trunk distribuisce il registro e l'infrastruttura, non specifici adattatori di canale o provider di agenti alternativi. I canali (Discord, Slack, Telegram, WhatsApp, …) vivono su un ramo channels a lunga durata; i provider alternativi (OpenCode, Ollama) vivono su providers. Esegui /add-telegram, /add-opencode, ecc. e la skill copia esattamente il modulo o i moduli che ti servono nel tuo fork. Nessuna funzionalità che non hai richiesto.

Miglior harness, miglior modello. NanoClaw usa nativamente Claude Code tramite l'SDK ufficiale Claude Agent di Anthropic, così ottieni i modelli Claude più recenti e il set completo di strumenti di Claude Code, inclusa la capacità di modificare ed espandere il tuo fork di NanoClaw. Altri provider sono opzioni drop-in: /add-codex per Codex di OpenAI (abbonamento ChatGPT o chiave API), /add-opencode per OpenRouter, Google, DeepSeek e altro tramite OpenCode, e /add-ollama-provider per modelli open-weight locali. Il provider è configurabile per gruppo di agenti.