Domande frequenti
Domande comuni su NanoClaw e come funziona.
NanoClaw è un assistente IA personale leggero e open source basato su Anthropic Claude Agent SDK. Gli agenti operano in container Linux isolati (Apple Container su macOS, Docker su macOS/Linux). WhatsApp integrato, altri canali tramite skill. Include memoria persistente SQLite, attività pianificate, accesso web, automazione del browser e sciami di agenti.
Esegui 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' e usa /setup nella sessione di Claude. Claude Code gestisce dipendenze, autenticazione, configurazione container e configurazione del servizio. Richiede Node.js 20+ e Claude Code.
NanoClaw è abbastanza piccolo da capire — un solo processo, pochi file sorgente, nessun microservizio. A differenza dei framework sovradimensionati, puoi leggere l'intero codice. Gli agenti operano in veri container Linux con isolamento del filesystem, non dietro controlli di permessi a livello applicativo.
NanoClaw funziona esclusivamente con Anthropic Claude Agent SDK. Claude Code è installato globalmente all'interno di ogni container e gestisce tutte le interazioni IA. L'SDK gestisce internamente la selezione del modello — NanoClaw è a fornitore singolo per scelta progettuale.
WhatsApp è il canale integrato (tramite libreria Baileys, associazione con codice QR). Telegram, Discord e Slack possono essere aggiunti tramite skill di Claude Code — esegui /add-telegram, /add-discord o /add-slack. Le skill modificano il codice sorgente del tuo fork per aggiungere un supporto canale pulito e dedicato.
La sicurezza è un principio progettuale fondamentale. Gli agenti operano in container Linux (Apple Container su macOS, Docker su macOS/Linux) con isolamento del filesystem — non dietro controlli di permessi a livello applicativo. I segreti vengono passati tramite stdin JSON e mai caricati in process.env. Liste di mount consentiti con rilevamento di escape tramite symlink. I container operano come utente non-root con mount del progetto in sola lettura.
NanoClaw usa SQLite (better-sqlite3) per l'archiviazione persistente — messaggi, gruppi, sessioni, attività pianificate e stato del router. Ogni gruppo ha anche il proprio file CLAUDE.md per la memoria per gruppo, montato nel suo container. Nessun database esterno necessario.
Sì. NanoClaw funziona su macOS e Linux — ovunque funzionino Node.js 20+ e Docker. Il nucleo leggero in TypeScript funziona su dispositivi con poche risorse, incluso Raspberry Pi. Richiede un runtime container (Apple Container o Docker) e una chiave API Anthropic.
Gli sciami di agenti permettono a NanoClaw di avviare squadre di agenti specializzati che collaborano su compiti complessi. NanoClaw è il primo assistente IA personale a supportare gli sciami di agenti, basato sulla funzionalità agent-teams di Claude Code.
Il progetto è open source con licenza MIT su github.com/qwibitai/nanoclaw. Consulta il README per le linee guida sui contributi. Tutti i contributi sono benvenuti.
Gli strumenti integrati sono forniti da Claude Code in esecuzione all'interno dei container: comandi shell, lettura/scrittura file, ricerca web, navigazione web (Chromium) e delega ad agenti (sciami). Il processo host fornisce attività pianificate (cron), memoria persistente SQLite e messaggistica WhatsApp. Estendi le funzionalità aggiungendo skill.
Sì. Ogni container dell'agente ha Chromium installato e agent-browser per l'automazione del browser. Claude Code può cercare nel web e navigare pagine per informazioni in tempo reale all'interno del container sandboxed.
Il repository ufficiale e unico affidabile è github.com/qwibitai/nanoclaw. Il Discord della comunità è discord.gg/VDdww8qS42.
macOS e Linux. Richiede Node.js 20+ e un runtime container — Apple Container su macOS o Docker su macOS/Linux. Windows non è ufficialmente supportato ma potrebbe funzionare tramite WSL2 con Docker.
NanoClaw usa esclusivamente Anthropic Claude tramite Claude Agent SDK. Imposta ANTHROPIC_API_KEY nel tuo file .env, oppure autenticati tramite Claude Code OAuth. Non c'è supporto multi-fornitore — l'SDK gestisce internamente la selezione del modello.
Il README nel repository GitHub (github.com/qwibitai/nanoclaw) è la fonte di documentazione principale. La directory docs/ contiene specifiche architetturali, modello di sicurezza e checklist di debug. Il codice è abbastanza piccolo da poter chiedere a Claude Code di guidarti attraverso di esso.
Canali ufficiali: Discord (discord.gg/VDdww8qS42) e GitHub (github.com/qwibitai/nanoclaw). Consulta il README per tutti i link della comunità.