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.

25.6k+ estrelas no GitHub

Por que NanoClaw?

NanoClaw oferece a mesma funcionalidade principal em uma base de código que você realmente consegue entender.

NanoClaw
OpenClaw
Arquivos fonte 15 3.680
Linhas de código ~3.900 434.453
Dependências <10 70
Arquivos de configuração 0 53
Tempo para entender 8 minutos 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 em Apple Container (macOS) ou Docker. Eles só podem ver o que você montar explicitamente.

🐝

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.

Mensagem Recebida
WhatsApp / Telegram
SQLite
armazenar e deduplicar
Fila de Grupo
FIFO por grupo
Contêiner
Claude Agent SDK
Resposta
transmitida de volta

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

index.ts — Orquestrador — loop de consulta, processamento de mensagens, invocação de agentes
container-runner.ts — Cria contêineres com montagens isoladas, transmite saída
group-queue.ts — Fila FIFO por grupo com limites de concorrência e backoff de tentativas
ipc.ts — Processa requisições IPC de contêineres com verificações de autorização
db.ts — SQLite — mensagens, sessões, grupos, tarefas, estado do roteador
task-scheduler.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.

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

Depois execute /setup Claude Code cuida de tudo: dependências, autenticação, configuração de contêineres, configuração de serviços.

Requisitos

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

Na Mídia

FAQ

O que é o NanoClaw?

O NanoClaw é um agente de IA pessoal, leve e de código aberto que roda na sua própria máquina. Ele se conecta a aplicativos de mensagens como WhatsApp, Telegram, Slack, Discord e Signal, executa cada sessão de agente dentro de um contêiner isolado (Docker ou Apple Container) e é construído com apenas 15 arquivos-fonte que você pode ler em uma única sessão. É construído sobre o Claude Agent SDK e projetado para pessoas que querem possuir e controlar completamente seu assistente de IA.

Como NanoClaw é diferente do OpenClaw?

O OpenClaw é um framework monolítico com milhares de arquivos-fonte e dezenas de dependências. O NanoClaw adota a abordagem oposta: ~15 arquivos-fonte, um único processo Node.js e isolamento real no nível do sistema operacional por meio de contêineres, em vez de verificações de permissão no nível da aplicação. Se você quer algo que pode auditar, entender e personalizar completamente, o NanoClaw foi feito para isso.

NanoClaw é seguro?

Segurança é um princípio central de design. Cada sessão de agente roda dentro de um contêiner Linux isolado com seu próprio sistema de arquivos, namespace IPC e espaço de processos. Agentes só podem acessar diretórios que são explicitamente montados, e não há acesso irrestrito ao seu sistema. Como toda a base de código tem cerca de 3.900 linhas de código em 15 arquivos, você pode realisticamente auditar tudo o que o software faz. Essa combinação de isolamento no nível do contêiner e uma base de código pequena e auditável faz do NanoClaw uma das formas mais transparentes e seguras de executar agentes de IA.

Preciso saber programar para usar o NanoClaw?

Não. O NanoClaw usa um processo de configuração nativo de IA onde o Claude Code cuida da instalação, configuração e mudanças contínuas de forma interativa. Você executa o skill /setup e segue as instruções. Se quiser personalizar o comportamento depois, você descreve o que quer em linguagem natural e o Claude Code modifica o código para você. Dito isso, espera-se que você esteja confortável com um terminal e executando comandos como git clone.

O NanoClaw é gratuito?

O NanoClaw em si é completamente gratuito e de código aberto sob a licença MIT. No entanto, ele roda sobre o Claude Agent SDK, que requer uma chave de API do Claude ou uma assinatura do Claude Code. O custo depende de quanto você usa. O NanoClaw é projetado para ser leve no uso de tokens, mas o uso subjacente de IA é cobrado pela Anthropic.

Quais aplicativos de mensagens NanoClaw suporta?

NanoClaw vem com suporte a WhatsApp nativo e pode ser estendido para funcionar com Telegram, e-mail e outros canais através do sistema de skills. Adicionar Telegram é tão simples quanto executar a skill /add-telegram, que te guia por toda a configuração. A arquitetura é projetada para que os canais de mensagens sejam modulares, então você pode executar um ou múltiplos canais lado a lado, cada um com sua própria configuração.

Quais runtimes de contêiner são suportados?

NanoClaw suporta tanto Apple Container quanto Docker. No macOS, Apple Container oferece sandboxing rápido e leve otimizado para Apple silicon, enquanto Docker está disponível como alternativa. No Linux, Docker é usado automaticamente. Durante o processo inicial de /setup, você escolhe qual runtime usar com base na sua plataforma e preferências.

Posso executar NanoClaw no Linux?

Sim. NanoClaw roda tanto no macOS quanto no Linux. No Linux, Docker é usado como runtime de contêiner e é configurado automaticamente durante a configuração. Os requisitos do sistema são Node.js 20 ou superior, Claude Code e um runtime de contêiner (Docker no Linux). A skill /setup cuida de todas as verificações de dependências e configuração para sua plataforma.

Como configuro o NanoClaw?

NanoClaw usa um processo de configuração AI-nativo. Após clonar o repositório e executar Claude Code, você executa a skill /setup, que te guia na instalação de dependências, autenticação dos seus canais de mensagens, configuração do runtime de contêiner e inicialização dos serviços em segundo plano. Não há arquivos de configuração manuais para editar. Claude Code cuida de toda a configuração de forma interativa. Para alterações posteriores, você pode descrever o que deseja e Claude Code fará as modificações diretamente na base de código.

Como NanoClaw se compara a outros frameworks de agentes de IA?

A maioria dos frameworks de agentes de IA é projetada para equipes que constroem produtos. São grandes, complexos e exigem investimento significativo para entender. NanoClaw é projetado para indivíduos que querem um assistente de IA pessoal que possuem e controlam completamente. Ele roda como um único processo Node.js, usa isolamento real por contêiner em vez de sandboxing no nível da aplicação, e é pequeno o suficiente para entender completamente. Ele roda no Claude Agent SDK, dando acesso direto às capacidades do Claude sem camadas de abstração.

NanoClaw é open source?

Sim. Nano Claw é totalmente open source sob a licença MIT. Toda a base de código está disponível no GitHub, e contribuições são bem-vindas. O projeto incentiva forks e personalização. A filosofia é que seu agente de IA pessoal deve ser software funcional adaptado às suas necessidades exatas, não um framework genérico que você configura.