memovai /mimiclaw

MimiClaw: Personal Agent on a $5 chip. No OS(Linux). No Node.js. No Mac mini. No Raspberry Pi. No VPS. Hardware agents OS. On device Muse.

★ 5,828⑂ 895👁 50⑃ 117● 76▤ 2
CMITCreated 2026-02-04mimiclaw.io
Download: v0.1.1v0.1.1 ↓0.1.12026-03-17
+2
Daily
5,828
stars
895
forks
50
watchers
117
prs
76
issues
2
releases

README

MimiClaw: Pocket AI Assistant on a $5 Chip


  



  
  
  
  



  English | 中文 | 日本語


The world's first AI assistant(OpenClaw) on a $5 chip. No Linux. No Node.js. Just pure C

MimiClaw turns a tiny ESP32-S3 board into a personal AI assistant. Plug it into USB power, connect to WiFi, and talk to it through Telegram — it handles any task you throw at it and evolves over time with local memory — all on a chip the size of a thumb.

 Meet MimiClaw

- Tiny — No Linux, no Node.js, no bloat — just pure C
- Handy — Message it from Telegram, it handles the rest
- Loyal — Learns from memory, remembers across reboots
- Energetic — USB power, 0.5 W, runs 24/7
- Lovable — One ESP32-S3 board, $5, nothing else

 How It Works

!

You send a message on Telegram. The ESP32-S3 picks it up over WiFi, feeds it into an agent loop — the LLM thinks, calls tools, reads memory — and sends the reply back. Supports both Anthropic (Claude) and OpenAI (GPT) as providers, switchable at runtime. Everything runs on a single $5 chip with all your data stored locally on flash.

 Quick Start

 What You Need

- An ESP32-S3 dev board with 16 MB flash and 8 MB PSRAM (e.g. Xiaozhi AI board, ~$10)
- A USB Type-C cable
- A Telegram bot token — talk to @BotFather on Telegram to create one
- An Anthropic API key — from console.anthropic.com, or an OpenAI API key — from platform.openai.com

 Install

bash
 You need ESP-IDF v5.5+ installed first:
 https://docs.espressif.com/projects/esp-idf/en/v5.5.2/esp32s3/get-started/

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

idf.py set-target esp32s3



Ubuntu Install

Recommended baseline:

- Ubuntu 22.04/24.04
- Python = 3.10
- CMake = 3.16
- Ninja = 1.10
- Git = 2.34
- flex = 2.6
- bison = 3.8
- gperf = 3.1
- dfu-util = 0.11
- libusb-1.0-0, libffi-dev, libssl-dev

Install and build on Ubuntu:

bash
sudo apt-get update
sudo apt-get install -y git wget flex bison gperf python3 python3-pip python3-venv \
  cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0

./scripts/setup_idf_ubuntu.sh
./scripts/build_ubuntu.sh





macOS Install

Recommended baseline:

- macOS 12/13/14
- Xcode Command Line Tools
- Homebrew
- Python = 3.10
- CMake = 3.16
- Ninja = 1.10
- Git = 2.34
- flex = 2.6
- bison = 3.8
- gperf = 3.1
- dfu-util = 0.11
- libusb, libffi, openssl

Install and build on macOS:

bash
xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

./scripts/setup_idf_macos.sh
./scripts/build_macos.sh




 Configure

MimiClaw uses a two-layer config system: build-time defaults in mimi_secrets.h, with runtime overrides via the serial CLI. CLI values are stored in NVS flash and take priority over build-time values.

bash
cp main/mimi_secrets.h.example main/mimi_secrets.h


Edit main/mimi_secrets.h:

c
define MIMI_SECRET_WIFI_SSID       "YourWiFiName"
define MIMI_SECRET_WIFI_PASS       "YourWiFiPassword"
define MIMI_SECRET_TG_TOKEN        "123456:ABC-DEF1234ghIkl

Top issues

Discussions

Latest release

v0.1.1 v0.1.1 2026-03-17
Flashing Guide

 1. Merged firmware (easiest)

Download mimiclaw-full-v0.1.1.bin and flash with a single command:

bash
esptool.py --chip esp32s3 -b 460800 write_flash 0x0 mimiclaw-full-v0.1.1.bin


 2. Individual binaries (advanced)

bash
esptool.py --chip esp32s3 -b 460800 write_flash \
  0x0      bootloader-v0.1.1.bin \
  0x8000   partition-table-v0.1.1.bin \
  0xf000   ota_data_initial-v0.1.1.bin \
  0x20000  mimiclaw-v0.1.1.bin \
  0x420000 spiffs-v0.1.1.bin


 3. OTA update (for devices already running MimiClaw)

Upload mimiclaw-v0.1.1.bin via the OTA endpoint.

 4. First-time setup

Aft

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON