MimiClaw

一块拇指大小的 ESP32-S3 开发板，插上 USB 供电，连上 WiFi，再通过 Telegram 发条消息——它就能为你查资料、记笔记、设提醒，甚至记住你的偏好和习惯。

这就是 MimiClaw：全球首个运行在 5 美元芯片上的本地化 AI 助理，没有 Linux，没有 Node.js，只有纯粹的 C 代码。

它不依赖服务器，所有数据存在本地 Flash；它能 24/7 运行，功耗仅 0.5W；你关机重启后，它依然记得你是谁。

为什么说它“小而强”？

• 小巧：无操作系统、无运行时依赖，纯 C 实现，极致轻量
• 好用：通过 Telegram 对话，无需 App 或网页界面
• 忠诚：具备长期记忆能力，重启不丢上下文
• 能干：支持工具调用（如网页搜索、时间同步），可完成多步任务
• 可爱：硬件成本约 ¥30（如小智 AI 开发板），USB 即插即用

整个 Agent 循环——接收消息、调用 Claude、执行工具、读写记忆、返回回复——全部跑在一颗 ESP32-S3 芯片上。你的隐私数据从未离开设备。

快速开始

你需要准备：

• ESP32-S3 开发板：需 16MB Flash + 8MB PSRAM（推荐“小智 AI 板”，约 ¥30）
• USB Type-C 数据线
• Telegram Bot Token：在 Telegram 中联系 @BotFather 创建
• Anthropic API Key：从 console.anthropic.com 获取

⚠️ 国内用户注意：需配置 HTTP 代理以访问 Telegram 和 Anthropic 服务（下文详述）。

安装与配置

1. 安装 ESP-IDF v5.5+

MimiClaw 基于 Espressif 官方开发框架 ESP-IDF。请先按官方指南安装：
👉 https://docs.espressif.com/projects/esp-idf/en/v5.5.2/esp32s3/get-started/

2. 克隆并构建项目

git clone https://github.com/memovai/mimiclaw.git
cd mimiclaw
idf.py set-target esp32s3

3. 配置密钥

MimiClaw 采用两层配置机制：

• 编译时默认值：写在 main/mimi_secrets.h
• 运行时覆盖：通过串口 CLI 修改，存入 NVS Flash，优先级更高

首次配置：

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

编辑 main/mimi_secrets.h，填入你的信息：

#define MIMI_SECRET_WIFI_SSID       "你的WiFi名"
#define MIMI_SECRET_WIFI_PASS       "你的WiFi密码"
#define MIMI_SECRET_TG_TOKEN        "123456:ABC-DEF1234ghIkl..."
#define MIMI_SECRET_API_KEY         "sk-ant-api03-xxxxx"
#define MIMI_SECRET_SEARCH_KEY      ""   // 可选：Brave Search API Key
#define MIMI_SECRET_PROXY_HOST      ""   // 可选：代理地址（如 "192.168.1.83"）
#define MIMI_SECRET_PROXY_PORT      ""   // 可选：代理端口（如 "7897"）

🌐 国内用户代理设置建议：
若使用 Clash Verge 或 V2Ray，请确保开启「允许局域网连接」，并将 MIMI_SECRET_PROXY_HOST 设为电脑 IP（如 192.168.1.83），端口设为代理监听端口（如 7897）。

4. 编译并烧录

# 修改 mimi_secrets.h 后必须 fullclean
idf.py fullclean && idf.py build

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

# 烧录并监控（替换 PORT 为实际串口）
idf.py -p /dev/cu.usbmodem11401 flash monitor

运行时配置（无需重编译）

插上 USB 线，通过串口终端即可随时调整设置：

mimi> wifi_set MyHomeWiFi password123
mimi> set_tg_token 123456:NEW-TOKEN...
mimi> set_api_key sk-ant-api03-newkey...
mimi> set_proxy 192.168.1.83 7897
mimi> clear_proxy
mimi> set_model claude-sonnet-4-5-20250929
mimi> config_show     # 查看当前配置（敏感字段已脱敏）
mimi> config_reset    # 恢复编译时默认值

调试与运维命令

mimi> wifi_status          # 检查 WiFi 连接状态
mimi> heap_info            # 查看剩余内存（PSRAM 使用情况）
mimi> memory_read          # 查看 MEMORY.md 内容
mimi> memory_write "今天学会了新技能"  # 手动写入记忆
mimi> session_list         # 列出会话 ID
mimi> session_clear 12345  # 删除指定会话
mimi> restart              # 重启设备

记忆系统：全是可读文本

MimiClaw 将所有数据以纯文本形式存储在 Flash 文件系统中，你可以直接读取或编辑：

工具能力：不只是聊天

MimiClaw 支持 Anthropic 的 Tool Use 协议，实现 ReAct 式任务循环：

• web_search：通过 Brave Search API 获取实时信息（需配置 API Key）
• get_current_time：从网络获取准确时间，自动校准时钟

未来还将支持文件操作、本地传感器等扩展工具。

其他亮点功能

• WebSocket 网关：局域网内可通过 ws://<设备IP>:18789 直连，用于自定义前端
• OTA 远程升级：固件更新无需 USB，WiFi 一键刷写
• 双核并行：网络 I/O 与 AI 逻辑分核运行，提升响应速度
• HTTP 代理支持：内置 CONNECT 隧道，适配企业或家庭代理环境