Repolode
memovai

memovai/mimiclaw

Firmware de asistente personal con IA, escrito íntegramente en C, que funciona en un chip ESP32-S3 de 5 USD y conversa contigo por Telegram.

Estrellas
5,802
Forks
894
Issues abiertos
111
Último commit
hace 18 días

¿Qué es?

MimiClaw es un firmware que convierte una pequeña placa de desarrollo ESP32-S3 en un asistente personal con IA. El dispositivo se conecta a WiFi y recibe mensajes a través de un bot de Telegram. Cada mensaje pasa por un ciclo de agente en el que el LLM puede llamar a herramientas, leer la memoria almacenada y responder. Admite Anthropic (Claude) y OpenAI (GPT) como proveedores de modelos, y puedes cambiar entre ellos en tiempo de ejecución desde la consola serie.

El proyecto funciona sin Linux, Node.js ni servidor. La memoria, el historial de chat y la configuración se guardan como archivos de texto sin formato en la memoria flash de la placa, como SOUL.md, USER.md y MEMORY.md, que puedes leer y editar. El firmware incluye un programador cron que permite a la IA crear tareas recurrentes o de una sola ejecución, y un servicio heartbeat que revisa periódicamente HEARTBEAT.md y actúa sobre los pendientes.

Entre los demás componentes integrados se incluyen una gateway WebSocket en la red local, actualizaciones OTA del firmware por WiFi, una opción de proxy HTTP CONNECT y búsqueda web mediante claves de API de Tavily o Brave. Las compilaciones utilizan ESP-IDF v5.5 o posterior, con scripts de configuración para Ubuntu y macOS.

Funciones clave

  • 01Funciona en una placa ESP32-S3 sin Linux ni Node.js
  • 02Chatea con el asistente a través de un bot de Telegram
  • 03Admite modelos de Anthropic y OpenAI, y permite cambiar entre ellos en tiempo de ejecución
  • 04Guarda la memoria, la personalidad y el historial de chat como archivos de texto editables en la memoria flash
  • 05Tareas programadas y periódicas mediante cron y un archivo heartbeat
  • 06Búsqueda web mediante claves de API de Tavily o Brave

Casos de uso

  • Tener un asistente personal de bajo consumo y siempre activo en una placa de microcontrolador que no estés usando
  • Experimentar con agentes LLM en hardware integrado
  • Recibir recordatorios programados o resúmenes diarios por Telegram
  • Estudiar cómo se implementa en C un ciclo de agente mínimo al estilo ReAct

Inicio rápido

  1. 1

    Instala primero ESP-IDF v5.5 o posterior (consulta la guía oficial de ESP-IDF)

  2. 2

    Clona el repositorio

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

    Entra en la carpeta del proyecto y configura ESP32-S3 como destino

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

    Copia la plantilla de secretos, introduce los datos de WiFi, el token de Telegram y la clave de API; después, compila y carga el firmware por el puerto USB (JTAG)

    idf.py fullclean && idf.py build

Antes de usarlo

  • Requiere una placa ESP32-S3 con 16 MB de memoria flash y 8 MB de PSRAM, además de una clave de API de LLM de pago (Anthropic u OpenAI).
  • La configuración requiere ESP-IDF v5.5 o posterior y compilar y cargar el firmware, por lo que no es una instalación sencilla.
  • El chat se realiza a través de Telegram, así que se necesita un bot de Telegram y acceso a WiFi.

Temas

Preguntas frecuentes

¿Qué es mimiclaw?
Firmware de asistente personal con IA, escrito íntegramente en C, que funciona en un chip ESP32-S3 de 5 USD y conversa contigo por Telegram. MimiClaw es un firmware que convierte una pequeña placa de desarrollo ESP32-S3 en un asistente personal con IA. El dispositivo se conecta a WiFi y recibe mensajes a través de un bot de Telegram. Cada mensaje pasa por un ciclo de agente en el que el LLM puede llamar a herramientas, leer la memoria almacenada y responder. Admite Anthropic (Claude) y OpenAI (GPT) como proveedores de modelos, y puedes cambiar entre ellos en tiempo de ejecución desde la consola serie.
¿mimiclaw es gratuito? ¿Qué licencia tiene?
mimiclaw es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mimiclaw sigue mantenido?
Mantenimiento activo. El último commit de mimiclaw fue el 4 oct 2026.
¿Para qué puedo usar mimiclaw?
Tener un asistente personal de bajo consumo y siempre activo en una placa de microcontrolador que no estés usando Experimentar con agentes LLM en hardware integrado Recibir recordatorios programados o resúmenes diarios por Telegram Estudiar cómo se implementa en C un ciclo de agente mínimo al estilo ReAct
¿Cómo se instala mimiclaw?
Instala primero ESP-IDF v5.5 o posterior (consulta la guía oficial de ESP-IDF) Clona el repositorio: git clone https://github.com/memovai/mimiclaw.git Entra en la carpeta del proyecto y configura ESP32-S3 como destino: cd mimiclaw && idf.py set-target esp32s3 Copia la plantilla de secretos, introduce los datos de WiFi, el token de Telegram y la clave de API; después, compila y carga el firmware por el puerto USB (JTAG): idf.py fullclean && idf.py build
¿Dónde consigo mimiclaw?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/memovai/mimiclaw

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados