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
+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
#68[Bug] not installing8 comments · 2026-02-20#166现在的工程支持Deepseek的api吗?7 comments · 2026-03-31#47[Bug] HTTP request failed: ESP_ERR_NOT_SUPPORTED6 comments · 2026-02-16#142[Feature] any hope for Lilygo T-Display S3 support?5 comments · 2026-03-11#116[Feature] Ollama provider5 comments · 2026-03-04#78[Bug] Get Current Time5 comments · 2026-02-22#164[Question] feishu 集成报错4 comments · 2026-03-30#108Compilation fails on the add-feishu-integration branch4 comments · 2026-02-28
Discussions
Latest release
v0.1.1 v0.1.1 2026-03-17Flashing 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