MimiClaw 聚焦嵌入式边缘 AI 场景，基于 ESP32‑S3 硬件架构，采用无 OS 纯 C 底层开发，构建轻量化 AI Agent 运行环境。项目集成记忆持久化、大模型多服务商兼容、工具调用、心跳自主调度、串口 CLI 配置、OTA 升级等核心模块，所有用户数据本地落盘，为低成本硬件实现私有化、可自主运行的智能体提供完整开源实现。

一、项目核心定位

• 硬件基础：ESP32‑S3 开发板（成本约 5 美元，国产板约 30 元），无 Linux、无 Node.js、无操作系统，仅用纯 C 语言开发。

• 核心功能：将单片机变成口袋 AI 助手，通过 Telegram 收发消息，调用 Anthropic（Claude）/OpenAI 大模型，具备记忆、工具调用、定时任务、联网搜索能力。

• 数据安全：所有记忆、对话数据本地存储在芯片 Flash 中，隐私优先，无需依赖云端服务器。

二、核心特性

1. 极简硬件：单块 ESP32‑S3 开发板，USB 供电，可 7×24 小时运行。

2. 持久记忆：本地文本文件存储记忆、人设、用户偏好、对话历史，重启不丢失。

3. AI 能力：支持大模型工具调用、联网搜索、定时 Cron 任务、心跳自主执行任务。

4. 灵活配置：通过串口 UART 进行 CLI 命令调试，无需重新编译即可修改参数。

5. 多服务商兼容：支持 Anthropic Claude、OpenAI GPT，运行时可切换。

三、快速上手流程（从仓库页面提取）

1. 硬件准备

• ESP32‑S3 开发板（16MB Flash + 8MB PSRAM）

• USB‑C 数据线

• Telegram 机器人 Token、Anthropic/OpenAI API 密钥

2. 编译部署

1. 克隆仓库：git clone https://github.com/memovai/mimiclaw.git

2. 配置 WiFi、API 密钥、模型参数（修改main/secrets.h）

3. 编译、烧录固件到 ESP32‑S3

4. 串口调试或直接通过 Telegram 与 AI 助手交互

四、关键技术模块

1. 端口区分

• USB(JTAG)：用于固件烧录、调试

• COM(UART)：用于串口 CLI 交互、实时配置调试

2. 本地记忆文件

• SOUL.md：AI 人设，定义行为逻辑

• USER.md：用户信息、偏好设置

• MEMORY.md：长期记忆

• cron.json：定时任务配置

• 所有文件可直接读写修改

3. 工具与任务系统

• 内置网页搜索、获取时间、定时任务管理

• 心跳机制：定期检查任务，自动执行提醒、日程等自主任务

• 支持 OTA 无线固件更新、WebSocket 远程连接

五、项目意义

MimiClaw 打破了 AI 智能体必须依赖高性能服务器 / 树莓派的限制，把完整的 Agent 能力下沉到百元以内的嵌入式硬件，实现了边缘侧私有化 AI 助手，为低成本、隐私优先的个人 AI 硬件提供了开源解决方案mimiclaw.io。

六、License

MIT license

七、项目地址

https://github.com/memovai/mimiclaw