Logotipo da NanoClaw
NanoClaw

Análise profunda das funcionalidades principais do NanoClaw: isolamento de containers, WhatsApp e clusters de agentes

13 min de leitura

Mergulhe nas seis funcionalidades principais do NanoClaw: o modelo de segurança de isolamento de containers Linux, gerenciamento de contexto em grupos de WhatsApp, inferência em streaming do Claude Agent SDK, tarefas agendadas (cron), processamento paralelo em clusters de agentes e memória de grupo via SQLite.

Isolamento de containers: um sandbox para cada agente

O modelo de segurança do NanoClaw é construído sobre containers Linux. Sempre que você aciona uma tarefa de um agente, o NanoClaw cria um container Linux independente para ela. Este container possui seu próprio sistema de arquivos isolado — apenas os diretórios que você montar explicitamente estarão visíveis para o agente.

O que isso significa? Suponha que você peça ao Claude para ajudar a refatorar um projeto. O agente pode ler o diretório /home/user/project que você montou, mas não consegue acessar /home/user/personal ou o arquivo /etc/passwd do sistema. Os comandos Bash são executados apenas dentro do container; mesmo que alguém crie um prompt malicioso, não será possível escapar para a máquina hospedeira.

Atributos de segurança fundamentais:

  • Isolamento do sistema de arquivos: não montado = invisível
  • Políticas de rede controláveis: limite de conexões de saída por container
  • Isolamento de processos: o processo do agente não enxerga a árvore de processos do hospedeiro
  • Limites de recursos: limites configuráveis de CPU e memória

Comparado a executar o comando claude diretamente no seu terminal, o isolamento por container adiciona uma camada real de segurança — não é uma questão de "confiança", mas de isolamento forçado em nível de kernel.

Integração com WhatsApp: o Claude no seu celular

Esta é a funcionalidade mais impressionante do NanoClaw. Você cria um grupo no WhatsApp, adiciona o número do NanoClaw e começa a interagir — basta marcar o bot ou enviar uma mensagem para que o Claude responda.

Isolamento de contexto por grupo

Cada grupo do WhatsApp possui um contexto de conversa totalmente independente. O Grupo A discute refatoração de código, enquanto o Grupo B discute criação de conteúdo; os arquivos de memória CLAUDE.md de cada grupo são separados e não interferem entre si.

Experiência de uso real

text
Você: @nanoclaw ajude-me a analisar este log de erro    [upload server-error.log]NanoClaw: Analisei o log, o problema central é o esgotamento do pool de conexões do banco de dados...         Sugiro ajustar o max_connections de 20 para 50.

Todo o processo é feito pelo seu celular, sem precisar abrir o computador ou fazer login em uma página web. Você pode resolver problemas com a ajuda do Claude enquanto está a caminho do trabalho.

Implementação técnica

A integração com o WhatsApp é baseada na biblioteca @whiskeysockets/baileys, conectando-se via protocolo WhatsApp Web. O NanoClaw mantém um armazenamento persistente de mensagens em SQLite, garantindo que o histórico da conversa não seja perdido após reinicializações.

Claude Agent SDK: motor de agentes com streaming

O runtime de agentes do NanoClaw é baseado no Claude Agent SDK. Cada solicitação de agente é processada via streaming — os tokens são retornados um a um, para que você não fique olhando para uma tela em branco esperando o resultado.

O Agent SDK confere ao NanoClaw as capacidades completas do Claude:

  • Chamada de ferramentas (Tool Use): operações de arquivo, requisições de rede, comandos shell
  • Raciocínio em múltiplas etapas: tarefas complexas são automaticamente decompostas em passos executáveis
  • Gerenciamento de contexto: compressão automática de conversas longas para manter o orçamento de tokens sob controle

Tarefas agendadas: automatize seu fluxo de trabalho

O NanoClaw possui um agendador de tarefas integrado. Você pode configurar o Claude para executar tarefas periodicamente:

yaml
# Gerar relatório diário às 9h da manhãschedule: "0 9 * * *"prompt: "Resuma o progresso do trabalho de ontem e envie o relatório para o grupo"

Cenários comuns de automação:

  • Relatório diário: resumo de commits no Git e progresso do projeto
  • Monitoramento: verificação periódica da saúde dos serviços com relatório
  • Coleta de dados: extração e consolidação de dados de fontes específicas
  • Lembretes: contagem regressiva e alertas para eventos importantes

O agendador de tarefas suporta expressões cron padrão, persistidas em SQLite, com recuperação automática após reinicialização.

Clusters de agentes: colaboração multi-agente

Um único agente tem limitações. O NanoClaw suporta a inicialização de múltiplas instâncias de agentes para processar tarefas complexas em paralelo. Por exemplo, se você tem um grande repositório de código para revisar:

  1. Agente A analisa o código do frontend
  2. Agente B analisa o código do backend
  3. Agente C analisa a cobertura de testes
  4. Os resultados são consolidados em um relatório abrangente

Cada agente roda em um container independente, sem interferências. É a versão de IA do conceito de "dividir para conquistar".

Sistema de memória de grupo

Cada grupo do WhatsApp e cada sessão CLI possui seu próprio arquivo de memória. O NanoClaw utiliza SQLite para armazenar o histórico de conversas e informações cruciais, permitindo:

  • Contexto persistente: retome o estado da conversa anterior após reiniciar
  • Instruções personalizadas: cada grupo pode ter seu próprio CLAUDE.md, definindo preferências de comportamento
  • Recuperação de memória: o agente pode consultar informações de conversas passadas

Isso é muito mais eficiente do que começar do zero a cada conversa — o Claude sabe o que você pediu anteriormente, quais são suas preferências de estilo e qual é o contexto do projeto.

Conclusão

FuncionalidadeResumoCenário de uso
Isolamento de containerSandbox de segurança nível kernelManipulação de código e dados sensíveis
Integração WhatsAppClaude no celularTrabalho móvel, colaboração em equipe
Agent SDKMotor de inferência em streamingTarefas complexas de várias etapas
Tarefas agendadasFluxo de trabalho automatizadoRelatórios, monitoramento, coleta
Clusters de agentesMúltiplos agentes em paraleloRevisão de grandes projetos
Memória de grupoContexto persistenteAcompanhamento de projetos de longo prazo

Combinando essas funcionalidades, o NanoClaw deixa de ser apenas um "chatbot no terminal" — ele se torna uma plataforma de trabalho de IA pessoal programável, persistente e segura.