面向乐鑫 ESP 系列芯片的轻量级神经网络推理框架,用于在 AIoT 设备上运行 AI 模型。
memovai/mimiclaw
一款用纯 C 编写、运行在 5 美元 ESP32-S3 芯片上的个人 AI 助手固件,通过 Telegram 对话。
- Star
- 5,802
- Fork
- 894
- 未关闭 Issue
- 111
- 最近提交
- 18天前
这是什么?
MimiClaw 是一套固件,可以把一块小巧的 ESP32-S3 开发板变成个人 AI 助手。设备连接 WiFi 后,通过 Telegram 机器人接收消息。每条消息进入智能体循环,大模型可以调用工具、读取本地记忆,再把回复发回。支持 Anthropic(Claude)和 OpenAI(GPT)作为模型提供方,可通过串口命令行在运行时切换。
项目不依赖 Linux、Node.js 或服务器。记忆、聊天记录和配置都以纯文本文件保存在开发板的 flash 中,例如 SOUL.md、USER.md、MEMORY.md,可直接读取和编辑。固件内置 cron 调度器,AI 可以自行创建周期或一次性任务;心跳服务会定期检查 HEARTBEAT.md 并自主处理其中未完成的事项。
此外还包括局域网 WebSocket 网关、通过 WiFi 的 OTA 固件升级、HTTP CONNECT 代理支持,以及通过 Tavily 或 Brave API 密钥实现的网页搜索。编译基于 ESP-IDF v5.5 及以上版本,并提供 Ubuntu 和 macOS 的环境脚本。
核心功能
- 01运行在 ESP32-S3 开发板上,无需 Linux 或 Node.js
- 02通过 Telegram 机器人与助手对话
- 03支持 Anthropic 与 OpenAI 模型,运行时可切换
- 04记忆、人设和聊天记录以可编辑的文本文件保存在 flash 中
- 05通过 cron 和心跳文件实现定时与周期性任务
- 06可通过 Tavily 或 Brave API 密钥进行网页搜索
适用场景
- 在闲置的单片机开发板上运行低功耗、常驻的个人助手
- 在嵌入式硬件上试验大模型智能体
- 通过 Telegram 接收定时提醒或每日摘要
- 学习如何用 C 语言实现精简的 ReAct 风格智能体循环
快速上手
- 1
先安装 ESP-IDF v5.5 及以上版本(参考官方 ESP-IDF 指南)
- 2
克隆代码仓库
git clone https://github.com/memovai/mimiclaw.git - 3
进入项目目录并设置 ESP32-S3 目标芯片
cd mimiclaw && idf.py set-target esp32s3 - 4
复制密钥模板,填写 WiFi、Telegram 令牌和 API 密钥,然后通过 USB (JTAG) 端口编译并烧录
idf.py fullclean && idf.py build
使用前须知
- 需要带 16 MB 闪存和 8 MB PSRAM 的 ESP32-S3 开发板,并需要付费的大模型 API 密钥(Anthropic 或 OpenAI)。
- 需要安装 ESP-IDF v5.5 及以上版本并自行编译、烧录固件,安装并不简单。
- 聊天通过 Telegram 进行,因此需要 Telegram 机器人和 WiFi 网络。
标签
常见问题
- mimiclaw 是什么?
- 一款用纯 C 编写、运行在 5 美元 ESP32-S3 芯片上的个人 AI 助手固件,通过 Telegram 对话。 MimiClaw 是一套固件,可以把一块小巧的 ESP32-S3 开发板变成个人 AI 助手。设备连接 WiFi 后,通过 Telegram 机器人接收消息。每条消息进入智能体循环,大模型可以调用工具、读取本地记忆,再把回复发回。支持 Anthropic(Claude)和 OpenAI(GPT)作为模型提供方,可通过串口命令行在运行时切换。
- mimiclaw 可以免费使用吗?用的什么许可证?
- mimiclaw 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- mimiclaw 还在维护吗?
- 活跃维护中。mimiclaw 最近一次提交是在 2026年10月4日。
- mimiclaw 适合用来做什么?
- 在闲置的单片机开发板上运行低功耗、常驻的个人助手 在嵌入式硬件上试验大模型智能体 通过 Telegram 接收定时提醒或每日摘要 学习如何用 C 语言实现精简的 ReAct 风格智能体循环
- mimiclaw 怎么安装和运行?
- 先安装 ESP-IDF v5.5 及以上版本(参考官方 ESP-IDF 指南) 克隆代码仓库: git clone https://github.com/memovai/mimiclaw.git 进入项目目录并设置 ESP32-S3 目标芯片: cd mimiclaw && idf.py set-target esp32s3 复制密钥模板,填写 WiFi、Telegram 令牌和 API 密钥,然后通过 USB (JTAG) 端口编译并烧录: idf.py fullclean && idf.py build
- 在哪里获取 mimiclaw?
- 源代码和安装说明在 GitHub 上:https://github.com/memovai/mimiclaw
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一个简单易用的 C 语言游戏编程库,提供 2D/3D 图形、输入、音频等功能,无外部依赖。
把 ESP32 变成本地运行的 Wi-Fi 动态感应器,通过无线信号变化检测移动,无需摄像头或麦克风。
基于 ESP32 的开源低成本迷你四足机器人,可 3D 打印,带 OLED 表情屏。
用于在 ESP32 开发板和 Raspberry Pi 等 Linux 设备上自制 Muse 小工具的开源 SDK 与固件。
一款 ESP32 桌面显示屏,展示 Claude Code 用量限额,并在会话需要你处理时提醒。