Repolode
Enviar
memovai

memovai/mimiclaw

Firmware de assistente pessoal com IA, escrito em C puro, que roda em um chip ESP32-S3 de US$ 5 e conversa com você pelo Telegram.

Ver no GitHubSite
Estrelas
5,802
Forks
894
Issues abertas
111
Último commit
há 18 dias

O que é?

MimiClaw é um firmware que transforma uma pequena placa de desenvolvimento ESP32-S3 em um assistente pessoal com IA. O dispositivo se conecta ao WiFi e recebe mensagens por meio de um bot do Telegram. Cada mensagem entra em um loop de agente no qual o LLM pode chamar ferramentas, ler memórias armazenadas e enviar uma resposta. O projeto oferece suporte a Anthropic (Claude) e OpenAI (GPT) como provedores de modelos, e permite alternar entre eles em tempo de execução pelo console serial.

O projeto funciona sem Linux, Node.js ou servidor. Memórias, histórico de conversas e configurações são armazenados como arquivos de texto simples na memória flash da placa, como SOUL.md, USER.md e MEMORY.md, que você pode ler e editar. O firmware inclui um agendador cron que permite à IA criar tarefas recorrentes ou pontuais, além de um serviço de heartbeat que verifica periodicamente o HEARTBEAT.md e age sobre os itens pendentes.

Outros recursos integrados incluem um gateway WebSocket na rede local, atualizações OTA de firmware por WiFi, uma opção de proxy HTTP CONNECT e busca na web usando chaves de API do Tavily ou Brave. As compilações usam ESP-IDF v5.5 ou posterior, com scripts de configuração para Ubuntu e macOS.

Recursos principais

  • 01Roda em uma placa ESP32-S3 sem Linux ou Node.js
  • 02Converse com o assistente por meio de um bot do Telegram
  • 03Oferece suporte a modelos da Anthropic e da OpenAI, com alternância em tempo de execução
  • 04Armazena memórias, personalidade e histórico de conversas como arquivos de texto editáveis na memória flash
  • 05Tarefas agendadas e periódicas via cron e um arquivo de heartbeat
  • 06Busca na web usando chaves de API do Tavily ou Brave

Casos de uso

  • Ter um assistente pessoal de baixo consumo e sempre ligado em uma placa de microcontrolador que você já tenha
  • Experimentar agentes LLM em hardware embarcado
  • Receber lembretes agendados ou resumos diários pelo Telegram
  • Estudar como implementar em C um loop mínimo de agente no estilo ReAct

Início rápido

  1. 1

    Instale primeiro o ESP-IDF v5.5 ou posterior (consulte o guia oficial do ESP-IDF)

  2. 2

    Clone o repositório

    git clone https://github.com/memovai/mimiclaw.git
  3. 3

    Acesse a pasta do projeto e defina ESP32-S3 como alvo

    cd mimiclaw && idf.py set-target esp32s3
  4. 4

    Copie o modelo de secrets, preencha os dados do WiFi, o token do Telegram e a chave de API; em seguida, compile e grave o firmware pela porta USB (JTAG)

    idf.py fullclean && idf.py build

Antes de usar

  • Requer uma placa ESP32-S3 com 16 MB de memória flash e 8 MB de PSRAM, além de uma chave de API de LLM paga (Anthropic ou OpenAI).
  • A configuração exige ESP-IDF v5.5 ou posterior, além de compilar e gravar o firmware, portanto não é uma instalação simples.
  • O chat é feito pelo Telegram, então é necessário ter um bot do Telegram e acesso ao WiFi.

Tópicos

#embedded#esp32#telegram-bot#llm-agent#iot#edge-ai#personal-agent#ai#assistant#clawdbot

Perguntas frequentes

O que é mimiclaw?
Firmware de assistente pessoal com IA, escrito em C puro, que roda em um chip ESP32-S3 de US$ 5 e conversa com você pelo Telegram. MimiClaw é um firmware que transforma uma pequena placa de desenvolvimento ESP32-S3 em um assistente pessoal com IA. O dispositivo se conecta ao WiFi e recebe mensagens por meio de um bot do Telegram. Cada mensagem entra em um loop de agente no qual o LLM pode chamar ferramentas, ler memórias armazenadas e enviar uma resposta. O projeto oferece suporte a Anthropic (Claude) e OpenAI (GPT) como provedores de modelos, e permite alternar entre eles em tempo de execução pelo console serial.
mimiclaw é gratuito? Qual é a licença?
mimiclaw é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mimiclaw ainda é mantido?
Manutenção ativa. O último commit de mimiclaw foi em 4 de out. de 2026.
Para que posso usar mimiclaw?
Ter um assistente pessoal de baixo consumo e sempre ligado em uma placa de microcontrolador que você já tenha Experimentar agentes LLM em hardware embarcado Receber lembretes agendados ou resumos diários pelo Telegram Estudar como implementar em C um loop mínimo de agente no estilo ReAct
Como instalar mimiclaw?
Instale primeiro o ESP-IDF v5.5 ou posterior (consulte o guia oficial do ESP-IDF) Clone o repositório: git clone https://github.com/memovai/mimiclaw.git Acesse a pasta do projeto e defina ESP32-S3 como alvo: cd mimiclaw && idf.py set-target esp32s3 Copie o modelo de secrets, preencha os dados do WiFi, o token do Telegram e a chave de API; em seguida, compile e grave o firmware pela porta USB (JTAG): idf.py fullclean && idf.py build
Onde consigo mimiclaw?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/memovai/mimiclaw

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados