Repolode
memovai

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. 1

    先安装 ESP-IDF v5.5 及以上版本(参考官方 ESP-IDF 指南)

  2. 2

    克隆代码仓库

    git clone https://github.com/memovai/mimiclaw.git
  3. 3

    进入项目目录并设置 ESP32-S3 目标芯片

    cd mimiclaw && idf.py set-target esp32s3
  4. 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 数据每日更新。

相关项目