MimiClaw‌ 是一款基于 ‌ESP32-S3‌ 芯片的超轻量级AI助手，采用纯C语言开发，可在无操作系统（裸机）环境下运行，无需依赖Linux或Node.js，适合嵌入式AI与物联网开发者快速部署本地化AI代理。

核心功能亮点

• 7×24小时在线‌：低功耗（仅0.5W），可插在充电宝或USB口持续运行。
• 多模型支持‌：支持 DeepSeek、OpenAI、Claude 等主流大模型API。
• 自然语言交互‌：通过飞书或Telegram实现免APP对话。
• 硬件控制能力‌：可控制GPIO、RGB灯、舵机、传感器等外设。
• 本地持久化记忆‌：断电不丢，支持长期记忆与用户偏好存储。
• 工具调用与定时任务‌：支持网页搜索、时间获取、自动化调度等ReAct模式功能。

本小节以ESP32-S3 + Deepseek +飞书机器人为例进行部署和测试

1. 硬件准备

ESP32-S3 N16R8 开发板‌（必须为16MB Flash + 8MB PSRAM版本）
USB数据线

2. 软件环境搭建

本系列教程使用代码是从原项目代码移植为适用于Arduino开发环境的，故只需要ArduinoIDE加上ESP32板开发包即可，具体安装和配置请参考本站文章。

3. 获取Deepseek API密钥

4. 配置飞书机器人

在飞书开放平台创建企业自建应用并完成配置，步骤如下：

（1）创建企业自建应用
访问 飞书开放平台 https://open.feishu.cn/，使用飞书账号登录（个人账号即可，无需企业认证）。
点击页面右上角“创建企业自建应用”，填写应用名称（如“MimiClaw 控制”），点击“创建”。
进入应用管理页面后，在左侧菜单「凭证与基础信息」中，复制「App ID」和「App Secret」，妥善保存（后续配置 MimiClaw 需用到）。

（2）添加机器人能力并配置权限
在应用管理左侧菜单，点击「添加应用能力」，在弹出的列表中找到「机器人」，点击「配置」，启用机器人能力。
启用后，进入「权限管理」页面，搜索并添加以下 4 个核心权限（缺一不可）：
im:message：允许机器人发送消息
im:message.p2p_msg:readonly：允许机器人接收私聊消息
im:message:send_as_bot：允许机器人以自身身份回复消息
contact:user.base:readonly：允许机器人读取用户基础信息

（3）配置事件订阅（长连接模式）
为让嵌入式设备（ESP32-S3）能稳定接收飞书消息，采用长连接（WebSocket）模式订阅事件，无需公网 IP，配置步骤如下：
在应用管理左侧菜单，点击「事件与回调」。
订阅方式选择「使用长连接接收事件」，点击「保存」（无需填写回调地址）。
点击「添加事件」，在搜索框中输入「im.message.receive_v1」，勾选该事件（接收消息事件），点击「确认添加」，完成事件订阅。

长连接模式通过 WebSocket 全双工通道接收飞书回调，延迟低、稳定性高，非常适合嵌入式设备的网络场景。

（4）发布应用并添加机器人
在应用管理左侧菜单，点击「版本管理与发布」，点击「创建版本」，填写版本号（如 1.0.0），简要填写更新说明（如“初始版本，支持 RGB 彩灯控制”），提交审核。
个人账号创建的应用无需人工审核，提交后立即发布成功。

5. 项目配置与编译

下载或克隆项目源码：https://github.com/makingrobot/MimiClaw-Arduino.git
在ArduinoIDE中，打开MimiClaw-Arduino.ino文件

本项目移植自MimiClaw，基于ESP32-Arduino-Framework开发框架开发，

打开config.h文件，修改为你的开发板，目前项目支持
ESP32S3-DevkitC-1及兼容板（16M Flash、8M PSRAM）

用 #define BOARD_ESP32_S3_DEVKIT 1 来启用

ESP32S3-2.8寸LCD显示屏开发板 [图]

支持LCD显示输出（目前版本只滚动显示主要日志内容）
用 #define BOARD_ESP32_S3_LCD_2_8   1 来启用

修改开发板配置选项如下：

• FLASH Size：16MB(128Mb)
• PSRAM：OPI PSRAM
• Arduino Runs On: Core 0 (Agent主循环运行在Core 1上)
• Partion Scheme: 16M Flash(3MB APP/9.9MB SPIFFS)

编译上传

若上传后一直重启，可将开发板配置项 Earse All Flash选项设置为true后重试。

系统启动后，日志输出如下图

6. 配置

系统提供两种配置方式，这里我们介绍使用网页的配置方式，
通过手机或电脑连接上面的热点（以mimiclaw-开头），然后访问给定IP（此处为192.168.4.1），出现如下界面

其中WiFi配置和LLM配置是必须的，不然系统无法工作，当前版本支持 Anthropic、OpenAI和Deepseek 大语言模型，本例使用Deepseek
若要使用 飞书Bot 或 Telegram Bot，则需要填入相应设置，本例使用 飞书Bot
若要使用 Web搜索，当前版本支持Tavily 和 Brave 搜索，可选择其一设置，本例使用Tavily
若需使用 网络代理，可填入相应设置。

点击“保存”后，系统将自动重启

若相关设置无误，日志输出包含上面红框的内容，则说明配置正确，系统进行对话状态。

7.对话

MimiClaw提供多种类型的对话途径，本项目目前包含TelegramBot、飞书机器人、Websocket和串口控制台四种方式，这里只介绍飞书机器人和Websocket。

1.用飞书APP界面进行对话
前面我们配置了飞书机器人，在这里来使用它，打开飞书APP，找到机器人后直接发消息，如下图：

可以看到，系统先快速回复一个“mimi is working”，然后再回复对话内容（这是LLM的回复结果，有思考时间）。

2.在Websocket界面进行对话
Websocket是基于HTTP协议的长连接协议，MimiClaw内置一个Websocket服务端，可通过ws://ip:18789/进行连接和对话。
本例使用一个包装后的浏览器客户端（https://www.xpstem.com/app/mimiclaw/）来测试对话，如下图右侧

这里为了更好的观察系统的运行，把串口输出日志放在了左侧（用https://www.xpstem.com/app/serialtool/ 连接串口）
本例是一个用文本发起工具调用的示例（点亮LED）。

至此，我们就将一个AI Agent正常运行在一个30元左右的设备上了。
那么可以用它来做什么呢？
它内部是如何工作的呢？
我将在后续教程中进行讲解和分析，有兴趣的朋友请关注。