zclaw - assistente pessoal de IA que roda no ESP32 com 888KB

• Assistente de IA ultraleve que roda em placas ESP32, com o tamanho total do firmware limitado a menos de 888KiB
• Escrito em C, permite combinar em linguagem natural controle de GPIO, agendamento (cron), memória persistente e ferramentas personalizadas
• A imagem completa, incluindo Wi-Fi, TLS/criptografia e bundle de certificados, cabe em 888KiB, enquanto o código do app em si tem cerca de 25KB
• Suporta integração com Telegram e chat via web relay, além dos principais provedores de LLM como Anthropic, OpenAI e OpenRouter
• Testado nas placas ESP32-C3/S3/C6, publicado como open source (licença MIT), garantindo experimentos com IA embarcada e extensibilidade

---

Visão geral do projeto

• zclaw é um assistente pessoal de IA para ESP32, projetado com o objetivo de manter o tamanho total do firmware em menos de 888KiB
  • O firmware inclui a lógica do zclaw, o runtime ESP-IDF/FreeRTOS e também Wi-Fi, TLS e bundle de certificados
  • O código do app em si tem cerca de 25KB, ocupando apenas aproximadamente 4% da imagem total
• É escrito em C e oferece combinação de ferramentas por comandos em linguagem natural, além de controle de GPIO e funções de agendamento
• Com o lema “Fun to use, fun to hack on”, o projeto destaca experimentação por desenvolvedores e extensibilidade

Principais recursos

• Fornece interface de chat por Telegram ou web relay
• Suporta agendamento com reconhecimento de fuso horário: é possível configurar tarefas recorrentes ou únicas como daily, periodic e once
• Expansão de funcionalidades por meio de ferramentas embutidas e personalizadas
• Controle de leitura/gravação de GPIO e mecanismos de proteção embutidos como gpio_read_all
• Oferece memória persistente após reinicialização
• Permite escolher persona: neutral, friendly, technical, witty
• Integração com provedores de LLM: Anthropic, OpenAI, OpenRouter

Suporte de hardware

• Testado em: ESP32-C3, ESP32-S3, ESP32-C6
  • Outras variantes do ESP32 também podem funcionar com configuração manual
• Placa recomendada: Seeed XIAO ESP32-C3
• Inclui scripts para desenvolvimento local e ciclo de hacking
  • build.sh, flash.sh, provision-dev.sh, monitor.sh etc.

Instalação e configuração

• Fornece comando de bootstrap em uma linha para macOS/Linux
  • bootstrap.sh clona o repositório e depois executa install.sh
• É possível armazenar credenciais criptografadas com flash em modo seguro (--flash-mode secure)
• As credenciais de Wi-Fi e do LLM são configuradas com provision.sh
• Limite padrão de chamadas ao LLM: 100 por hora, 1000 por dia (pode ser alterado na compilação)
• É possível verificar a resposta do dispositivo com o script de teste (web-relay.sh)

Licença e informações do repositório

• Licença MIT
• Site oficial da documentação: zclaw.dev

[GN⁺]

Comentários do Hacker News

• Posso ter entendido errado, mas fiquei curioso se isso tem um LLM pequeno embarcado ou se é só um wrapper que precisa de conexão com a internet

  • É um wrapper. Basicamente usa a OpenAI API. Veja o link do código
  • A maioria dos projetos claw tem esse tipo de estrutura de wrapper

• O interessante de rodar claw no ESP32 não é o desempenho de computação, e sim o fato de ficar sempre ligado e quase não exigir manutenção
  Eu rodo pipelines de automação em um servidor Linux, e o maior problema não é a lógica de IA, e sim o gerenciamento do host. Atualizações, OOM, reinicializações etc.
  Se o ESP32 fizer proxy da API em nuvem e cuidar localmente da orquestração das ferramentas, ele acaba sendo um alvo de deploy mais estável para loops de agente simples

  • Fiquei curioso sobre qual OS está instalado e como funcionam as atualizações
  • Concordo totalmente. Microcontroladores são praticamente hosts com autorrecuperação — sem gerenciador de pacotes, sem upgrade de kernel, sem configuração de cgroup. Quando resetam, sempre voltam ao mesmo estado. Já no Linux, “deu problema depois do apt upgrade periódico” faz parte do dia a dia de depuração
  • Mas no Linux também não dá para simplificar? Eu opero vários servidores Apache e eles funcionam bem se eu mexer neles só quando chega o EOL
  • Mas isso também cria mais pontos de falha. Servidor em nuvem, internet, conexão sem fio etc. Se qualquer um deles cair, dá problema. Não é uma abordagem ruim, mas não reduz os problemas

• Alguém consegue explicar a ADC (conversor analógico-digital) do SoC ESP do ponto de vista de engenharia?
  Quem já usou diz que é chatinha, mas ouvi dizer que, sabendo lidar, dá para usar no nível de chips STM
  O ESP32 era um dos únicos chips mais relevantes a usar ISA própria, e depois migrou para RISC-V

  • A especificação da ADC do ESP32 é definida de forma bem vaga. Se esse “saber lidar” incluir calibração de precisão ou caracterização, coisas difíceis de fazer em ambiente de produção, então essa provavelmente é a resposta
  • A ISA anterior do ESP32 era baseada em IP adquirido da Tensilica
  • A ADC do ESP32 não é para áudio de alta fidelidade, e sim para controle de entrada simples. Tipo ligar um potenciômetro para receber entrada física. Para obter valores estáveis, é preciso fazer média de várias amostras. Para monitorar tensões que mudam devagar, serve bem o suficiente

• Será que existe uma versão colaborativa desse tipo de claw? Algo como uma versão self-hosted que uma família possa usar junto
  Ouvi dizer que o OpenClaw tem perfis, mas fiquei curioso se ele suporta ao mesmo tempo chats individuais e chats compartilhados

  • Eu mesmo fiz algo parecido. Um bot self-hosted baseado em Signal, com suporte a chats em grupo
    Recentemente adicionei uma função de automação de compras — ele cria uma lista inicial com base no histórico de pedidos e, quando os membros da família ajustam essa lista, o agente usa ferramentas de navegador para montar o carrinho. O pagamento ainda é manual, mas já está quase pronto. Acho que um projeto assim deve virar open source em breve

• Tenho alguns ESP32 com pequenas telas OLED e estou pensando em fazer um Tamagotchi inteligente com isso. Mais alguma ideia?

  • Eu fiz algo parecido, mas no fim tudo vira escrever uma máquina de estados. O LLM não decide bem sozinho coisas como “quando deve comer”. No fim, você vai adicionando variáveis e regras sem parar e acaba perdendo a direção
  • Isso é muito legal. Por acaso é a versão com display ultracompacto de 0,46 polegada? Dá para fazer muita coisa divertida com ele

• Pensando bem, o OpenClaw parece o ROS (Robot Operating System) do mundo dos agentes de IA
  Ele define como nós distribuídos interagem e permite combinar vários nós funcionais para formar um sistema maior

  • Mas existe mesmo alguma especificação ou protocolo assim? Pelo que vi, parece mais uma plataforma com várias integrações em cima. Usei por uma semana e essa foi a impressão que tive

• Sou um homem simples. Vejo ESP32 e já dou upvote

• Alguma recomendação de agente estilo claw leve para Linux? Não preciso de contêiner nem sandbox

  • Eu uso o picoclaw
  • Se você só quer WhatsApp e chat web, eu uso meu frontend web em cima do piclaw. Fica como um webapp acessível via Tailscale
  • Vale considerar o zeroclaw também

• Faz tempo que eu não via este padrão

  bash <(curl foo.sh)
  

  Normalmente se usa

  curl foo.sh | bash
  

  mas ambos são arriscados do ponto de vista de segurança. Em vez disso, recomendo o método abaixo

  curl foo.sh | tee /tmp/foo.sh | bash
  bash -c "$(curl foo.sh)"
  curl foo.sh -o /tmp/foo.sh && bash $_
  

  Eu prefiro o último método

  • Já ouvi que salvar em um arquivo temporário e depois executar é melhor do que “passar curl direto para o bash”. Mas no fim a questão da confiança é a mesma. A menos que você leia o código, nunca é totalmente seguro
  • Para deixar mais seguro, vale fazer algo como

    t=$(mktemp) && [ -w $t ] && curl foo.sh -o $t && echo "$t ..." | sha256sum -c - && bash $t
    

    e adicionar verificação de hash
  • Se quiser fazer tudo certinho, outra opção é escrever de forma independente de shell

• Esses projetos claw na verdade têm uma estrutura bem simples. Basta dar ao LLM permissão para chamar APIs e pronto

  • O que me surpreendeu nessa febre do OpenClaw foi ver tanta gente que nem conhece conceitos básicos de computação. Parece que nunca olharam para fora da pasta node_modules
  • Tenho desenvolvido meu próprio claw ultimamente, e dizer que “não tem nada demais” é como olhar para uma chapa de compensado com quatro rodas e dizer que carro não tem nada demais. Para fazer um assistente pessoal de verdade, a coisa é bem mais complexa
  • Se todo mundo passar a rodar agentes pessoais 24/7, talvez isso exija muito mais recursos computacionais do que se imagina. Claro, ainda não sabemos se isso de fato vai acontecer
  • Programação é a mesma coisa. É como dizer: “é só digitar no teclado”
  • No fim, logo vamos descobrir o que acontece quando você dá um biscoito a um rato