AIBit-探索开源项目 AIBit-探索开源项目

MimiClaw：仅 $5 的 ESP32‑S3 芯片上的小型 AI 助手。

认识 MimiClaw，这是首款在仅 $5 的 ESP32‑S3 板上运行的对话 AI，既不需要 Linux 也不需要 Node.js。它由边缘端的 Claude 提供支持，所有数据本地存储，使用 Telegram 进行消息传递，并通过 Brave Search 支持网页搜索。该项目提供即插即用的设置、双核设计、OTA 更新，甚至支持 WebSocket 网关。本文将带您了解其独特架构、快速开始指南、配置选项以及实际应用案例，帮助热衷于寻找私密、隐私优先 AI 助手的爱好者和开发者尝试 MimiClaw。

MimiClaw：仅 $5 的 ESP32‑S3 芯片上的小型 AI 助手

全世界首款仅用一块 $5 面包板即可运行、所有信息保存在片上（on‑chip）的聊天机器人。MimiClaw 将 Claude 的对话能力、与本地记忆和灵活的工具调用协议引入边缘设备，让您在 Telegram 机器人后面回答问题、安排任务、上网——一切都在本地。

为什么 MimiClaw 是颠覆者

  • 零臃肿 – 仅编译纯 C 代码在 ESP32‑S3 上运行；不需要 Linux、Node.js 或外部服务器。
  • 成本与尺寸 – 基于 16 MB flash、8 MB PSRAM 开发板（约 $10）——一块手指大小的芯片。
  • 隐私优先 – 所有数据存储在内部闪存，从不上传到云端。
  • 能耗低 – 通过 USB 5 V 供电，功耗 <0.5 W，可 24/7 在线。
  • 可扩展 – 支持网页搜索（Brave Search API）、当前时间获取、OTA 固件升级、WebSocket 网关及 HTTP 代理。

系统概览

MimiClaw 采用 OpenClaw 架构。当通过 Telegram API 接收消息时，ESP32‑S3

  1. 通过 Wi‑Fi 检索消息。
  2. 将文本通过 Anthropic API 发送给 Claude。
  3. 执行 ReAct 循环：Claude 可以调用工具（如 web_search、get_current_time），反复执行直到任务完成。
  4. 将回复实时返回给用户。

所有会话数据（聊天历史、记忆文件、日志）均以纯文本文件保存在闪存中——

  • SOUL.md 控制机器人个性。
  • USER.md 保存用户偏好。
  • MEMORY.md 存放长期知识。
  • 日志按日期保存。

固件分布在两核 CPU 上：一核处理网络 I/O，另一核负责 AI 推理和工具执行，保证运行流畅。

快速开始指南

以下是让您的第一台 MimiClaw 正常运行的逐步说明：

  1. 硬件 – 购买一块带 16 MB flash / 8 MB PSRAM 的 ESP32‑S3 开发板（如 Xiaozhi AI 板）。准备一个 USB‑C 电缆。
  2. 软件 – 按官方指南安装 ESP‑IDF 5.5+。
  3. 克隆仓库
    git clone https://github.com/memovai/mimiclaw.git
cd mimiclaw
idf.py set-target esp32s3
  4. 配置密钥 – 复制示例文件并填入凭证：
    cp main/mimi_secrets.h.example main/mimi_secrets.h
    • MIMI_SECRET_WIFI_SSID – 您的 Wi‑Fi SSID
    • MIMI_SECRET_WIFI_PASS – Wi‑Fi 密码
    • MIMI_SECRET_TG_TOKEN – 来自 @BotFather 的 Telegram 机器人令牌
    • MIMI_SECRET_API_KEY – Anthropic API 密钥
    • （可选）MIMI_SECRET_SEARCH_KEY – Brave Search API 密钥
  5. 编译与烧录
    idf.py fullclean && idf.py build
idf.py -p <PORT> flash monitor
  6. 交互 – 给 Telegram 机器人发送一条消息；您将在不到一分钟内收到回复。

运行时配置

设备启动后，您可以通过串口 CLI 调整设置：

  • wifi_set SSID PASS – 切换 Wi‑Fi
  • set_tg_token TOKEN – 更改 Telegram 令牌
  • set_api_key KEY – 切换 Anthropic 密钥或 LLM 模型
  • set_proxy IP PORT – 配置 HTTP 代理
  • set_search_key KEY – 启用网页搜索
  • config_show – 查看当前运行时配置
  • memory_read / memory_write \"text\" – 查看与编辑长期记忆

设置会保存在 NVS flash 中，重启后仍然有效。

用例与示例

个人知识库

向 MEMORY.md 添加笔记，或让助手提醒您添加事实；它将在重启后记住这些内容。

任务自动化

使用 ReAct 循环让 MimiClaw 安排事件、发送邮件或拉取 API 数据——所有操作仅需发送简短消息。

上网与事实核查

开启 Brave Search 并请求最新新闻；MimiClaw 会在不向外部服务器泄露查询的前提下获取实时数据。

教育项目

学生可探索 LLM 如何与受限硬件交互，研究 OTA 更新流程，或为自定义工具修改架构。

未来路线图

MimiClaw 仓库已包含 docs/TODO.md，追踪即将上线的功能：

  • 扩展工具集（如文件 I/O、GPS、传感器数据）
  • 支持更多 LLM 服务商
  • 通过 HTTP/WebSocket 为更丰富的前端提供 UI 网关
  • 针对 8 MB flash 版本的性能优化

我们邀请开源贡献者帮助构建这些功能、微调记忆处理，并将 MimiClaw 适配到其他微控制器。

结语

MimiClaw 证明了一个强大、隐私优先的 AI 助手可以装在仅 $5 的 ESP32‑S3 上——无服务器、完全本地化、且完全开源。无论您是业余爱好者、教育工作者，还是早期采用者，MimiClaw 都提供了一个具体的入口，让您迈入边缘 AI 与嵌入式对话代理的世界。

深入代码，调节记忆文件，让您的机器人从您身上学习——同时确保数据安全、离线运行。