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
下载:v0.1.1v0.1.1 ↓0.1.12026-03-17
+2
日增长
5,828
stars
895
forks
50
watchers
117
prs
76
issues
2
releases

README

MimiClaw: $5 芯片上的口袋 AI 助理


  



  
  
  
  



  English | 中文 | 日本語


$5 芯片上的 AI 助理(OpenClaw)。没有 Linux,没有 Node.js,纯 C。

MimiClaw 把一块小小的 ESP32-S3 开发板变成你的私人 AI 助理。插上 USB 供电,连上 WiFi,通过 Telegram 跟它对话 — 它能处理你丢给它的任何任务,还会随时间积累本地记忆不断进化 — 全部跑在一颗拇指大小的芯片上。

 认识 MimiClaw

- 小巧 — 没有 Linux,没有 Node.js,没有臃肿依赖 — 纯 C
- 好用 — 在 Telegram 发消息,剩下的它来搞定
- 忠诚 — 从记忆中学习,跨重启也不会忘
- 能干 — USB 供电,0.5W,24/7 运行
- 可爱 — 一块 ESP32-S3 开发板,$5,没了

 工作原理

!

你在 Telegram 发一条消息,ESP32-S3 通过 WiFi 收到后送进 Agent 循环 — LLM 思考、调用工具、读取记忆 — 再把回复发回来。同时支持 Anthropic (Claude) 和 OpenAI (GPT) 两种提供商,运行时可切换。一切都跑在一颗 $5 的芯片上,所有数据存在本地 Flash。

 快速开始

 你需要

- 一块 ESP32-S3 开发板,16MB Flash + 8MB PSRAM(如小智 AI 开发板,~¥30)
- 一根 USB Type-C 数据线
- 一个 Telegram Bot Token — 在 Telegram 找 @BotFather 创建
- 一个 Anthropic API Key — 从 console.anthropic.com 获取,或一个 OpenAI API Key — 从 platform.openai.com 获取

 安装

bash
 需要先安装 ESP-IDF v5.5+:
 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 安装

建议基线:

- 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

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 安装

建议基线:

- 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

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




 配置

MimiClaw 使用两层配置:mimi_secrets.h 提供编译时默认值,串口 CLI 可在运行时覆盖。CLI 设置的值存在 NVS Flash 中,优先级高于编译时值。

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


编辑 main/mimi_secrets.h:

c
define MIMI_SECRET_WIFI_SSID       "你的WiFi名"
define MIMI_SECRET_WIFI_PASS       "你的WiFi密码"
define MIMI_SECRET_TG_TOKEN        "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
define MIMI_SECRET_API_KEY         "sk-ant-api03-xxxxx"
define MIMI_SECRET_MODEL_PROVIDER  "anthropic"     // "anthropic" 或 "openai"
define MIMI_SECRET_SEARCH_KEY      ""              // 可选:Brave Search API key
define MIMI_SECRET_TAVILY_KEY      ""              // 可选:Tavily API key(优先)
define MIMI_SECRET_PROXY_HOST      "10.0.0.1"      // 可选:代理地址
define MIMI_SECRET_PROXY_PORT      "7897"           // 可选:代理端口


然后编译烧录:

bash
 完整编译(修改 mimi_secrets.h 后必须 fullclean)
idf.py fullclean && idf.py build

 查找串口
ls /dev/cu.usb           macOS
ls /dev/ttyACM           Linux

 烧录并监控(将 PORT 替换为你的串口)
 USB 转接器:大概率是 /dev/cu.usbmodem11401(macOS)或 /dev/ttyACM0(Linux)
idf.py -p PORT flash monitor


 注意:请插对 USB 口! 大多数 ESP32-S3 开发板有两个 Type-C 接口,必须插标有 USB 的那个口(原生 USB 

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