NanoClaw
Seu agente de IA pessoal. Seguro. Leve. Seu.
O site oficial do NanoClaw, o agente de IA pessoal seguro. NanoClaw roda com segurança em contêineres, projetado para ser compreendido e personalizado para suas necessidades.
Por que NanoClaw?
NanoClaw oferece a mesma funcionalidade principal em uma base de código que você realmente consegue entender.
| | OpenClaw | |
|---|---|---|
| Arquivos fonte | 132 | 3.680 |
| Linhas de código | ~17.500 | 434.453 |
| Dependências | <10 | 70 |
| Arquivos de configuração | 0 | 53 |
| Tempo para entender | Uma tarde | 1–2 semanas |
| Modelo de segurança | Isolamento por contêiner do SO | Verificações no nível da aplicação |
| Arquitetura | Processo único + contêineres isolados | Processo único, memória compartilhada |
O Que Suporta
Tudo o que NanoClaw suporta nativamente, e nada que você não precisa.
Aplicativos de Mensagens
WhatsApp, Telegram e mais. Envie mensagens para seu agente NanoClaw pelo celular através dos aplicativos que você já usa.
Isolamento em Contêineres
Agentes rodam isolados em Docker (macOS, Linux, WSL2), com Apple Container disponível como opção nativa do macOS.
Enxames de Agentes NOVO
NanoClaw pode criar equipes de agentes especializados que colaboram em tarefas complexas. Primeira IA pessoal a suportar isso.
Memória Por Grupo
Cada grupo tem sua própria memória CLAUDE.md, sistema de arquivos isolado e roda em seu próprio contêiner sandbox.
Tarefas Agendadas
Tarefas recorrentes que executam Claude e te enviam a resposta. Resumos matinais, revisões semanais e mais.
Sistema de Skills
Estenda funcionalidades sem inchaço. Adicione Gmail, Telegram ou capacidades personalizadas via skills.
Configuração AI-Nativa
Sem assistentes de instalação. Claude Code guia tudo: dependências, autenticação, contêineres, serviços.
Acesso à Web
NanoClaw pode pesquisar na web, buscar conteúdo e navegar páginas para pesquisar qualquer coisa.
Arquitetura
NanoClaw é um único processo Node.js. Agentes em contêineres isolados. 15 arquivos fonte.
Processo Único
Um processo Node.js consulta mensagens, gerencia filas, cria contêineres e lida com IPC. Sem microsserviços, sem message brokers.
Isolamento Por Grupo
Cada grupo recebe seu próprio contêiner, sistema de arquivos, namespace IPC e sessão Claude. Grupos não podem acessar dados de outros grupos.
Controle de Concorrência
GroupQueue limita contêineres simultâneos (padrão: 3). Ordenação FIFO por grupo com tentativas de reexecução em caso de falha usando backoff exponencial.
IPC via Sistema de Arquivos
Contêineres se comunicam com o host através de arquivos JSON em diretórios por grupo. O host consulta, valida autorização, executa e faz a limpeza.
Arquivos Principais
src/index.ts — Orquestrador — loop de consulta, processamento de mensagens, invocação de agentes src/container-runner.ts — Cria contêineres com montagens isoladas, transmite saída src/router.ts — Fila FIFO por grupo com limites de concorrência e backoff de tentativas src/delivery.ts — Processa requisições IPC de contêineres com verificações de autorização src/db/ — SQLite — mensagens, sessões, grupos, tarefas, estado do roteador src/host-sweep.ts — Execução de tarefas agendadas por cron, intervalo e execução única Filosofia
Os princípios que moldam cada decisão do NanoClaw.
Pequeno o suficiente para entender
NanoClaw é um processo, um punhado de arquivos fonte. Pequeno o suficiente para que você possa ler e entender toda a base de código.
Seguro por isolamento
Agentes rodam em contêineres Linux. Eles só podem ver o que é explicitamente montado. Bash é seguro porque roda dentro do contêiner.
Feito para um usuário
NanoClaw não é um framework monolítico. É software funcional que se adapta às suas necessidades exatas. Faça um fork, peça ao Claude Code para adaptá-lo ao seu uso.
AI-nativo
Sem assistente de instalação; Claude Code guia a configuração. Sem painel; pergunte ao Claude. Sem ferramentas de depuração; descreva o problema.
Skills em vez de funcionalidades
Contribuidores adicionam skills do Claude Code como /add-telegram que transformam sua instalação. Você acaba com código limpo que faz exatamente o que você precisa.
Melhor harness, melhor modelo
Roda no Claude Agent SDK, o que significa que você está rodando Claude Code diretamente. O harness importa. Um bom harness dá superpoderes a modelos inteligentes.
Comece com NanoClaw em 3 Linhas
Clone o NanoClaw, entre no diretório e deixe o Claude cuidar do resto.
$ git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
$ cd nanoclaw-v2
$ bash nanoclaw.sh nanoclaw.sh walks you from a fresh machine to a named agent you can message. It installs Node, pnpm, and Docker if missing, registers your Anthropic credential with OneCLI, builds the agent container, and pairs your first channel. If a step fails, Claude Code is invoked automatically to diagnose and resume.