NanoClaw

Il tuo agente IA personale. Sicuro. Leggero. Tuo.

NanoClaw gira in modo sicuro nei container, progettato per essere compreso e personalizzato per le tue esigenze.

stelle su GitHub

Perché NanoClaw?

NanoClaw offre le stesse funzionalità principali in un codice sorgente che puoi davvero comprendere.

NanoClaw
OpenClaw
File sorgente 15 3.680
Righe di codice ~3.900 434.453
Dipendenze <10 70
File di configurazione 0 53
Tempo per comprendere 8 minuti 1–2 settimane
Modello di sicurezza Isolamento container a livello di SO Controlli a livello applicativo
Architettura Processo singolo + container isolati Processo singolo, memoria condivisa

Cosa Supporta

Tutto ciò che NanoClaw supporta nativamente, e niente che non ti serve.

💬

App di Messaggistica

WhatsApp, Telegram e altro. Invia messaggi al tuo agente NanoClaw dal telefono tramite le app che usi già.

🔒

Isolamento in Container

Gli agenti girano in Apple Container (macOS) o Docker. Possono vedere solo ciò che monti esplicitamente.

🐝

Sciami di Agenti NUOVO

NanoClaw può creare team di agenti specializzati che collaborano su compiti complessi. La prima IA personale a supportare questo.

🧠

Memoria Per Gruppo

Ogni gruppo ha la propria memoria CLAUDE.md, filesystem isolato e gira nel proprio container sandbox.

Attività Programmate

Attività ricorrenti che eseguono Claude e ti inviano la risposta. Briefing mattutini, revisioni settimanali e altro.

🧩

Sistema di Skills

Estendi le funzionalità senza appesantire. Aggiungi Gmail, Telegram o capacità personalizzate tramite skills.

Configurazione AI-Nativa

Nessuna procedura guidata di installazione. Claude Code guida tutto: dipendenze, autenticazione, container, servizi.

🌐

Accesso al Web

NanoClaw può cercare nel web, recuperare contenuti e navigare pagine per ricercare qualsiasi cosa.

Architettura

NanoClaw è un singolo processo Node.js. Agenti in container isolati. 15 file sorgente.

Messaggio In Arrivo
WhatsApp / Telegram
SQLite
memorizza e deduplica
Coda di Gruppo
FIFO per gruppo
Container
Claude Agent SDK
Risposta
trasmessa indietro

Processo Singolo

Un processo Node.js interroga i messaggi, gestisce le code, avvia container e gestisce IPC. Nessun microservizio, nessun message broker.

Isolamento Per Gruppo

Ogni gruppo riceve il proprio container, filesystem, namespace IPC e sessione Claude. I gruppi non possono accedere ai dati di altri gruppi.

Controllo della Concorrenza

GroupQueue limita i container simultanei (predefinito: 3). Ordinamento FIFO per gruppo con tentativi di riesecuzione in caso di errore usando backoff esponenziale.

IPC tramite Filesystem

I container comunicano con l'host tramite file JSON nelle directory per gruppo. L'host interroga, valida l'autorizzazione, esegue e pulisce.

File Principali

index.ts — Orchestratore — ciclo di interrogazione, elaborazione messaggi, invocazione agenti
container-runner.ts — Avvia container con montaggi isolati, trasmette l'output
group-queue.ts — Coda FIFO per gruppo con limiti di concorrenza e backoff dei tentativi
ipc.ts — Elabora richieste IPC dei container con controlli di autorizzazione
db.ts — SQLite — messaggi, sessioni, gruppi, attività, stato del router
task-scheduler.ts — Esecuzione di attività programmate tramite cron, intervallo e esecuzione singola

Filosofia

I principi che guidano ogni decisione di NanoClaw.

🔍

Piccolo abbastanza da comprendere

NanoClaw è un processo, un pugno di file sorgente. Piccolo abbastanza da poter leggere e comprendere l'intero codice sorgente.

🛡️

Sicuro per isolamento

Gli agenti girano in container Linux. Possono vedere solo ciò che è esplicitamente montato. Bash è sicuro perché gira all'interno del container.

👤

Costruito per un utente

NanoClaw non è un framework monolitico. È software funzionante che si adatta alle tue esigenze esatte. Fai un fork, chiedi a Claude Code di adattarlo alle tue necessità.

🤖

AI-nativo

Nessuna procedura guidata di installazione; Claude Code guida la configurazione. Nessuna dashboard; chiedi a Claude. Nessuno strumento di debug; descrivi il problema.

🧩

Skills invece di funzionalità

I collaboratori aggiungono skills di Claude Code come /add-telegram che trasformano la tua installazione. Ottieni codice pulito che fa esattamente ciò che ti serve.

Miglior harness, miglior modello

Gira su Claude Agent SDK, il che significa che stai eseguendo Claude Code direttamente. L'harness conta. Uno buono dà superpoteri ai modelli intelligenti.

Inizia con NanoClaw in 3 Righe

Clona NanoClaw, entra nella directory e lascia che Claude faccia il resto.

Terminale
$ git clone https://github.com/qwibitai/nanoclaw.git
$ cd nanoclaw
$ claude

Poi esegui /setup Claude Code gestisce tutto: dipendenze, autenticazione, configurazione container, configurazione servizi.

Requisiti

macOS o Linux Node.js 20+ Claude Code Apple Container (macOS) o Docker

Nella Stampa

FAQ

In cosa NanoClaw è diverso da OpenClaw?

NanoClaw (anche noto come Nano Claw) adotta un approccio fondamentalmente diverso. Mentre OpenClaw è un framework su larga scala con migliaia di file sorgente e decine di dipendenze, NanoClaw è un agente IA personale leggero costruito con circa 15 file sorgente che puoi leggere e comprendere in una sola sessione. NanoClaw usa l'isolamento container a livello di SO (Docker o Apple Container) per creare un sandbox per ogni sessione dell'agente, anziché affidarsi a controlli di permesso a livello applicativo. Se stai cercando un'alternativa sicura e minimale a OpenClaw che puoi controllare e personalizzare completamente, NanoClaw è progettato esattamente per questo.

NanoClaw è sicuro?

La sicurezza è un principio di design fondamentale. Ogni sessione dell'agente gira all'interno di un container Linux isolato con il proprio filesystem, namespace IPC e spazio dei processi. Gli agenti possono accedere solo alle directory che sono esplicitamente montate, e non c'è accesso implicito al tuo sistema. Poiché l'intero codice sorgente è di circa 3.900 righe di codice in 15 file, puoi realisticamente verificare tutto ciò che il software fa. Questa combinazione di isolamento a livello container e un codice sorgente piccolo e verificabile rende NanoClaw uno dei modi più trasparenti e sicuri per eseguire agenti IA.

Quali app di messaggistica supporta NanoClaw?

NanoClaw include il supporto WhatsApp nativo e può essere esteso per funzionare con Telegram, email e altri canali tramite il sistema di skills. Aggiungere Telegram è semplice come eseguire la skill /add-telegram, che ti guida attraverso l'intera configurazione. L'architettura è progettata in modo che i canali di messaggistica siano modulari, quindi puoi eseguire uno o più canali in parallelo, ognuno con la propria configurazione.

Quali runtime container sono supportati?

NanoClaw supporta sia Apple Container che Docker. Su macOS, Apple Container offre sandboxing veloce e leggero ottimizzato per Apple silicon, mentre Docker è disponibile come alternativa. Su Linux, Docker viene usato automaticamente. Durante il processo iniziale di /setup, scegli quale runtime usare in base alla tua piattaforma e preferenze.

Posso eseguire NanoClaw su Linux?

Sì. NanoClaw funziona sia su macOS che su Linux. Su Linux, Docker viene usato come runtime container ed è configurato automaticamente durante la configurazione. I requisiti di sistema sono Node.js 20 o successivo, Claude Code e un runtime container (Docker su Linux). La skill /setup gestisce tutti i controlli delle dipendenze e la configurazione per la tua piattaforma.

Come configuro NanoClaw?

NanoClaw usa un processo di configurazione AI-nativo. Dopo aver clonato il repository e avviato Claude Code, esegui la skill /setup, che ti guida nell'installazione delle dipendenze, autenticazione dei tuoi canali di messaggistica, configurazione del runtime container e avvio dei servizi in background. Non ci sono file di configurazione manuali da modificare. Claude Code gestisce l'intera configurazione in modo interattivo. Per modifiche successive, puoi descrivere ciò che desideri e Claude Code apporterà le modifiche direttamente nel codice sorgente.

Come si confronta NanoClaw con altri framework di agenti IA?

La maggior parte dei framework di agenti IA è progettata per team che costruiscono prodotti. Sono grandi, complessi e richiedono un investimento significativo per essere compresi. NanoClaw è progettato per individui che vogliono un assistente IA personale che possiedono e controllano completamente. Funziona come un singolo processo Node.js, usa un vero isolamento container anziché sandboxing a livello applicativo, ed è piccolo abbastanza da comprendere completamente. Gira su Claude Agent SDK, dandoti accesso diretto alle capacità di Claude senza livelli di astrazione.

NanoClaw è open source?

Sì. Nano Claw è completamente open source sotto la licenza MIT. L'intero codice sorgente è disponibile su GitHub e i contributi sono benvenuti. Il progetto incoraggia fork e personalizzazione. La filosofia è che il tuo agente IA personale dovrebbe essere software funzionante su misura per le tue esigenze esatte, non un framework generico da configurare.