前言

最近我做了一个很有意思的小项目：把 AI 助理部署到了 ESP32-S3 开发板上。

它不是传统意义上跑在 Linux 设备上的那种“重型 AI 系统”，而是一个更轻量、更贴近硬件控制场景的方案。这个项目叫 Esp32Claw，基于 MimiClaw 进行改造，目标是在一块成本很低的 ESP32-S3 开发板上，实现一个真正可交互、可扩展、可控制外设的 AI 助理。

简单来说，你可以把它理解成：

一个常驻在 ESP32-S3 上的轻量 AI Agent，它能接收飞书消息，理解你的自然语言指令，并执行具体操作。

比如：

• 控制 GPIO
• 读写本地文件
• 控制 WS2812B 灯带/灯珠做呼吸灯
• 查询设备当前状态
• 作为一个低成本、低功耗、可长期在线的智能硬件中枢

这类项目最大的乐趣就在于：
AI 不再只是聊天，而是真正“接管设备、理解指令、执行动作”。

github地址：https://github.com/zhangjun2636808827/esp32claw

---

这个项目是做什么的？

我的项目地址是 Esp32Claw。
它基于开源项目 MimiClaw，并在此基础上做了更适合自己使用场景的扩展和优化。仓库 README 中写得很清楚：项目运行在 ESP32-S3 开发板上，可以实现飞书控制 GPIO、读写本地文件、控制 WS2812B 实现呼吸灯等功能。

和很多“AI + 单片机”的演示项目不一样，我更想把它做成一个 真正可日常折腾、可持续扩展、可作为智能控制入口的 DIY 项目。

也就是说，它不是只演示一句“hello world”或者点亮一下 LED 就结束了，而是具备：

• 聊天入口
• 指令解析
• 工具调用
• 设备状态管理
• 外设控制
• 持续运行能力

这也是我觉得它值得单独写出来分享的原因。

---

为什么选择基于 MimiClaw 改造？

MimiClaw 本身就很有意思，它的特点是：

• 没有 Linux
• 没有 Node.js
• 没有臃肿依赖
• 纯 C 实现
• 低功耗，可长期运行

原项目强调的是“小巧、忠诚、能长期在线”的 AI 助理体验，而这正好很适合 ESP32 这类芯片平台。

但在实际折腾时，我还是希望它更贴近自己的使用习惯，所以我在 Esp32Claw 里做了一些比较实用的改造。

---

我对项目做了哪些增强？

根据仓库当前 README，Esp32Claw 相比原始 MimiClaw 主要做了这些修改：

1. 接入 MiniMax API

我把模型接入方式切换到了 MiniMax，README 里给出的方案是使用其 Starter 套餐，并在配置中使用 MiniMax-M2.7，提供者设置为 openai。

这对我来说有两个好处：

• 接入方式更顺手
• 成本相对可控，适合个人 DIY 项目持续使用

2. 增加 WS2812B 驱动

我给项目增加了 WS2812B 驱动，实现了呼吸灯功能。
这让它不再只是“能聊”的 AI，而是能很直观地通过灯效反馈设备状态、运行状态，甚至可以作为桌面氛围灯的一部分。

比如你可以直接通过飞书给它发消息，控制灯的颜色、亮度和呼吸周期。

3. 增加设备状态查询工具

这是我自己很喜欢的一个增强点。

现在可以通过飞书直接查询设备状态，包括：

• Wi-Fi 状态
• IP 地址
• 运行时长
• 内存
• PSRAM
• 当前灯模式
• 颜色
• 亮度
• 呼吸周期

这意味着它不只是一个“执行器”，还是一个可以被远程查看状态的智能节点。

4. 优化 Wi-Fi 重连逻辑

原本这类嵌入式联网项目很容易遇到一个现实问题：
网络一抖，程序就不稳。

所以我专门修改了 Wi-Fi 重连逻辑，尽量避免设备在异常网络环境下宕机。

5. 修复和精简一些运行逻辑

我还做了两个比较偏工程化的优化：

• 优化了仅配置飞书时，Telegram 分支仍然运行的问题
• 优化了连接 Wi-Fi 后本地管理 AP 常驻的问题，减少资源占用

这些改动不一定是最显眼的功能点，但对“让项目更适合长期跑起来”很重要。

---

这个项目适合谁？

我觉得它特别适合下面几类人：

1. 喜欢 ESP32 / 单片机 DIY 的开发者

如果你平时就喜欢接继电器、灯带、传感器、GPIO 外设，那这个项目会很有意思，因为 AI 可以成为你控制设备的新入口。

2. 想做“AI + 硬件”结合的人

很多人会写 Agent，但只停留在软件层；也很多人会玩硬件，但交互方式还停留在按钮和串口。这个项目刚好把这两件事连起来了。

3. 想做低成本智能终端的人

项目 README 里提到，核心平台就是一块成本很低的 ESP32-S3 开发板。对于想做低预算智能设备原型的人来说，这是一个很不错的方向。

---

它具体能怎么玩？

我自己理解，这个项目后续可以往很多方向扩展：

桌面智能助手

通过飞书直接发送自然语言命令，让 ESP32 控制桌面灯光、风扇、继电器或者状态提示灯。

宿舍 / 家庭自动化入口

把它接到更多 GPIO 外设上，就可以变成一个很轻量的家庭控制节点。

AI 控制面板

它已经具备“聊天 + 工具调用 + 状态反馈”的雏形，后续可以继续扩展成更完整的设备管理中心。

嵌入式 AI Agent 实验平台

如果你对“AI Agent 能不能跑到更小的硬件平台上”感兴趣，这个项目就是一个很好的实验基础。

---

环境需求和部署门槛高吗？

从仓库说明来看，项目需要的硬件主要包括：

• ESP32-S3 开发板，推荐 16MB Flash + 8MB PSRAM
• USB Type-C 数据线
• 飞书机器人
• 大模型 API

软件侧基于 ESP-IDF v5.5+，README 里也补充了 Windows 11 下的安装步骤，包括克隆 ESP-IDF、安装环境、设置目标芯片、复制配置文件、填写飞书和 MiniMax 的配置，然后再进行编译和烧录。

这说明它并不是那种“纯小白一键运行”的项目，但如果你本身有一点 ESP32 开发基础，其实上手成本是可以接受的。

---

我为什么想把它开源出来？

一开始做这个项目，其实更多是出于个人兴趣和折腾欲。
但做着做着，我越来越觉得这类项目挺有价值：

因为它让 AI 从“云端聊天框”真正走进了“真实设备控制”。

相比直接在电脑或者手机上跑大模型，我更喜欢这种感觉：

• 一块便宜的开发板
• 一个长期在线的小系统
• 一个可以通过自然语言调用的硬件节点
• 一套能继续加传感器、灯效、文件、任务调度的基础框架

这类东西可能不是最华丽的，但很“接地气”，也很适合开发者自己二次开发。

所以我把它整理成了开源项目，希望能给同样喜欢 ESP32、AI Agent、智能硬件、低成本 DIY 的朋友一点参考。

---

后续计划

接下来我还想继续往下面几个方向完善：

• 接入更多硬件外设
• 增强设备侧工具能力
• 优化部署和配置体验
• 增加更多适合中文场景的交互方式
• 让它更像一个真正可长期运行的嵌入式 AI 助理

如果你也对这个方向感兴趣，欢迎一起交流、提建议，或者直接基于这个项目继续改。

---

项目总结

如果你也想做一个：

• 跑在 ESP32-S3 上
• 能接收自然语言指令
• 能通过飞书远程控制
• 能操作 GPIO / 文件 / 灯效
• 成本低、功耗低、可持续在线

的 AI 小设备，那我觉得 Esp32Claw 会是一个不错的起点。
它不是“堆参数”的路线，而是更偏向 轻量、实用、可落地、可扩展 的方向。项目当前已经明确支持飞书控制、WS2812B 呼吸灯、设备状态查询、Wi-Fi 重连优化等能力。

对我来说，这不是一个单纯的 Demo，
而是一次把 AI Agent 真正塞进微控制器世界 的尝试。

---

结尾引导

如果你对这个项目感兴趣，欢迎去看源码、点个 Star，也欢迎留言交流你希望它接下来还能扩展哪些功能。
比如：

• 你最想让它接什么传感器？
• 你希望它支持哪些控制指令？
• 你会拿它做桌面助手、宿舍控制器，还是智能家居入口？