NanoClaw

Seu agente de IA pessoal. Seguro. Leve. Seu.

NanoClaw roda com segurança em contêineres, projetado para ser compreendido e personalizado para suas necessidades.

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

Como NanoClaw é diferente do OpenClaw?

NanoClaw (também conhecido como Nano Claw) adota uma abordagem fundamentalmente diferente. Enquanto OpenClaw é um framework de grande escala com milhares de arquivos fonte e dezenas de dependências, NanoClaw é um agente de IA pessoal leve construído com cerca de 15 arquivos fonte que você pode ler e entender em uma única sessão. NanoClaw usa isolamento por contêiner no nível do SO (Docker ou Apple Container) para criar um sandbox para cada sessão de agente, em vez de depender de verificações de permissão no nível da aplicação. Se você está procurando uma alternativa segura e mínima ao OpenClaw que pode auditar e personalizar completamente, NanoClaw foi projetado exatamente 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.

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.