Perguntas Frequentes
Perguntas comuns sobre o NanoClaw e como ele funciona.
NanoClaw é um assistente pessoal de IA leve e open-source construído com o Anthropic Claude Agent SDK. Agentes rodam em containers Linux isolados (Apple Container no macOS, Docker no macOS/Linux). WhatsApp integrado, outros canais via skills. Possui memória persistente em SQLite, tarefas agendadas, acesso web, automação de navegador e Enxames de Agentes.
Execute 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' e use /setup na sessão do Claude. O Claude Code cuida das dependências, autenticação, configuração do container e configuração do serviço. Requer Node.js 20+ e Claude Code.
O NanoClaw é pequeno o suficiente para entender — um processo, poucos arquivos fonte, sem microsserviços. Diferente de frameworks inchados, você pode ler todo o código. Agentes rodam em containers Linux reais com isolamento de sistema de arquivos, não atrás de verificações de permissão no nível da aplicação.
O NanoClaw roda exclusivamente no Anthropic Claude Agent SDK. O Claude Code é instalado globalmente dentro de cada container e gerencia todas as interações de IA. O SDK gerencia a seleção de modelo internamente — o NanoClaw é de provedor único por design.
WhatsApp é o canal integrado (via biblioteca Baileys, pareamento por QR code). Telegram, Discord e Slack podem ser adicionados via skills do Claude Code — execute /add-telegram, /add-discord ou /add-slack. Skills modificam o código-fonte do seu fork para adicionar suporte dedicado e limpo ao canal.
Segurança é um princípio central de design. Agentes rodam em containers Linux (Apple Container no macOS, Docker no macOS/Linux) com isolamento de sistema de arquivos — não atrás de verificações de permissão no nível da aplicação. Secrets são passados via stdin JSON e nunca carregados em process.env. Allowlists de montagem com detecção de escape por symlink. Containers rodam como não-root com montagens de projeto somente leitura.
O NanoClaw usa SQLite (better-sqlite3) para armazenamento persistente — mensagens, grupos, sessões, tarefas agendadas e estado do roteador. Cada grupo também tem seu próprio arquivo CLAUDE.md para memória por grupo, montado no seu container. Sem necessidade de banco de dados externo.
Sim. O NanoClaw roda no macOS e Linux — em qualquer lugar que Node.js 20+ e Docker rodem. O núcleo leve em TypeScript funciona em dispositivos com poucos recursos, incluindo Raspberry Pi. Requer um runtime de containers (Apple Container ou Docker) e uma chave de API da Anthropic.
Enxames de Agentes permite que o NanoClaw crie equipes de agentes especializados que colaboram em tarefas complexas. O NanoClaw é o primeiro assistente pessoal de IA a suportar enxames de agentes, construído sobre a capacidade agent-teams do Claude Code.
O projeto é open-source sob licença MIT em github.com/qwibitai/nanoclaw. Confira o README para diretrizes de contribuição. Todas as contribuições são bem-vindas.
Ferramentas integradas são fornecidas pelo Claude Code rodando dentro dos containers: comandos shell, leitura/escrita de arquivos, busca na web, navegação web (Chromium) e delegação de agentes (enxames). O processo host fornece tarefas agendadas (cron), memória persistente em SQLite e mensagens via WhatsApp. Estenda a funcionalidade adicionando skills.
Sim. Cada container de agente tem Chromium instalado e agent-browser para automação de navegador. O Claude Code pode pesquisar na web e navegar em páginas para informações em tempo real dentro do container em sandbox.
O repositório oficial e único confiável é github.com/qwibitai/nanoclaw. O Discord da comunidade é discord.gg/VDdww8qS42.
macOS e Linux. Requer Node.js 20+ e um runtime de containers — Apple Container no macOS ou Docker no macOS/Linux. Windows não é oficialmente suportado, mas pode funcionar via WSL2 com Docker.
O NanoClaw usa Anthropic Claude exclusivamente via Claude Agent SDK. Configure ANTHROPIC_API_KEY no seu arquivo .env, ou autentique via Claude Code OAuth. Não há suporte multi-provedor — o SDK gerencia a seleção de modelo internamente.
O README no repositório do GitHub (github.com/qwibitai/nanoclaw) é a fonte principal de documentação. O diretório docs/ contém especificações de arquitetura, modelo de segurança e checklist de debug. O código é pequeno o suficiente para você pedir ao Claude Code para te guiar por ele.
Canais oficiais: Discord (discord.gg/VDdww8qS42) e GitHub (github.com/qwibitai/nanoclaw). Confira o README para todos os links da comunidade.