Coloque o NanoClaw pra Rodar
Núcleo leve em TypeScript, um caminho de instalação. Clone, rode claude, use /setup.
checklist Requisitos do Sistema
Node.js 20+ (LTS recomendado)
macOS ou Linux. Windows via WSL2 pode funcionar, mas não é oficialmente suportado.
512MB+ de RAM. Runtime leve, sem compilação pesada.
~50MB instalado (node_modules). Imagem do container adiciona ~500MB.
Necessário: Apple Container (macOS) ou Docker (macOS/Linux). Necessário: Claude Code CLI.
Internet necessária para chamadas à API da Anthropic. Sem modo offline.
Clone o repo e comece com o Claude CLI. Funcionando em minutos.
One-Liner
Requires Claude CLI. All platforms.
git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude Step-by-Step
Clone first, then configure. More control.
git clone https://github.com/qwibitai/NanoClaw.git cd NanoClaw && npm install # Run claude and use /setup for guided configuration # Or edit .env and src/index.ts directly verified Verifique Sua Instalação
Execute estes comandos para confirmar que o NanoClaw está instalado corretamente.
node -e "console.log(require('./package.json').version)" Deve exibir o número da versão instalada.
npm test Executa a suíte de testes (vitest) para verificar dependências e funcionalidades principais.
claude Abre o Claude Code. Execute /setup dentro da sessão para configuração guiada.
settings Configuração Inicial
O Claude Code cuida da configuração via /setup. Veja o que ele configura.
Instalar Dependências
O Claude Code executa npm install e constrói a imagem do container (nanoclaw-agent:latest) com Chromium, agent-browser e Claude Code pré-instalados.
Autenticar
Configure ANTHROPIC_API_KEY no .env, ou autentique via Claude Code OAuth. Secrets são passados para containers em tempo de execução, nunca carregados em process.env.
Conectar WhatsApp
Execute 'npm run auth' para parear via QR code. WhatsApp é o canal integrado. Adicione Telegram, Discord ou Slack depois via skills (/add-telegram, /add-discord, /add-slack).
Iniciar o Agente
Execute 'npm start' para iniciar o NanoClaw. Ele conecta ao WhatsApp, inicia o loop de polling de mensagens e começa a processar mensagens em containers isolados.
.env — O NanoClaw não usa arquivos de configuração. Para fazer alterações, diga ao Claude Code o que você quer. O código é pequeno o suficiente para o Claude modificar com segurança.
system_update_alt Atualizando o NanoClaw
Mantenha o NanoClaw atualizado para obter as últimas features, integrações e correções de segurança.
cd NanoClaw && git pull && npm install cd NanoClaw && git pull && docker compose up --build Confira o changelog em github.com/qwibitai/nanoclaw/releases para ver as novidades de cada versão.
build Solução de Problemas
Problemas comuns e como resolvê-los.
Precisa de Ajuda?
Junte-se à nossa comunidade para suporte de instalação e solução de problemas.