project
MimiClaw - 开源超轻量级AI助手,无需高级运行环境
MimiClaw是基于ESP32-S3芯片的超轻量级AI助手,采用纯C语言编写,能直接在裸机上运行,无需Linux、Node.js或操作系统。
MimiClaw是什么
MimiClaw是基于ESP32-S3芯片的超轻量级AI助手,采用纯C语言编写,能直接在裸机上运行,无需Linux、Node.js或操作系统。MimiClaw实现7×24小时在线,通过Telegram或WebSocket提供Claude/GPT智能服务。MimiClaw具备持久化记忆系统(SOUL.md/USER.md/MEMORY.md)、工具调用支持搜索/定时任务和硬件控制能力,所有数据本地存储隐私优先,是边缘AI与Agent硬件化的极致工程实践。
MimiClaw的主要功能
-
智能对话:通过Telegram Bot或WebSocket与Claude/GPT模型实时聊天,支持双Provider运行时切换。
-
本地记忆:MimiClaw以Markdown文件形式持久化存储AI人格、用户信息和长期记忆,断电重启不丢失。
-
自主调度:内置Cron调度器与心跳机制,使AI能创建定时任务和主动检查执行待办事项。
-
工具调用:支持网络搜索、获取时间、GPIO硬件控制等工具,实现ReAct模式的Agent循环。
-
无线运维:支持OTA固件更新和HTTP代理,无需物理连接即可完成部署与网络适配。
MimiClaw的技术原理
- 裸机架构:基于ESP-IDF框架用纯C语言开发,直接运行于ESP32-S3硬件而无需Linux或Node.js运行时,通过精简依赖将代码体积控制在16MB Flash内。
- 双核任务分配:用ESP32-S3的双核Xtensa LX7处理器,将网络IO协议栈绑定CPU0,Agent推理与工具执行置于CPU1,实现并发处理避免阻塞。
- 流式内存管理:针对512KB SRAM限制,采用HTTP流式传输与分块JSON解析,避免一次性加载大响应导致内存溢出,同时通过PSRAM扩展存储临时数据。
- ReAct状态机:用纯C实现ReAct(推理-行动-观察)循环的状态机,维护多轮对话上下文,解析LLM返回的JSON工具调用指令和驱动本地工具执行。
- SPIFFS持久化:在Flash上建立SPIFFS文件系统,将记忆、配置和任务队列以纯文本形式存储,实现零依赖的数据持久化与人工可编辑性。
MimiClaw的项目地址
- 项目官网:https://mimiclaw.io/
- GitHub仓库:https://github.com/memovai/mimiclaw
MimiClaw的应用场景
- 个人随身助理:作为口袋级AI伴侣,插在充电宝或车载USB上即可7×24小时在线,随时通过Telegram查询日程、记录灵感或获取建议,无需依赖手机算力或云端订阅。
- 智能家居中枢:作为低功耗家庭网关,连接温湿度传感器、继电器等GPIO设备,通过自然语言指令控制家电,本地记忆用户习惯实现个性化自动化。
- 工业边缘节点:部署在工厂或农田等场景,定时采集设备数据并自主判断异常,通过心跳机制主动上报,0.5W功耗适合太阳能供电的无人值守环境。
- 教育开发平台:开源裸机代码为嵌入式学习者提供Agent工程实践样本,低成本硬件降低AIoT开发门槛,适合高校物联网与边缘计算课程。