本文最后更新于38 天前,其中的信息可能已经过时,如有错误请发送邮件到2778680280@qq.com
作者:初开
发布时间:2026-03-18
mimiclaw 是 openclaw 的衍生项目,采用C 语言开发,基于 esp-idf 实现,因此可运行在 esp-idf 支持的所有硬件设备上。
一、烧录固件
硬件准备
需准备搭载 8 MB PSRAM 和 16 MB flash 的 esp32 或 esp32-s3 设备。
烧录步骤
- 将准备好的设备连接至电脑;
- 通过 espressif 官方提供的 ESP Launchpad 进行固件烧录;
- https://espressif.github.io/esp-launchpad/?flashConfigURL=https://hexchip.com/upload/esp-launchpad/mimiclaw/config.toml
- 点击网页右上角Connect按钮连接设备,再点击左下角Flash按钮开始烧录;
- 工具将自动下载固件,耗时约 1 分钟,下载完成后会自动跳转到Console页面展示烧录进度。
二、配置 mimiclaw
mimiclaw 需完成WIFI、LLM 语言大模型、飞书机器人三项核心配置,配置前需准备串口调试工具(推荐 Windows 应用商店的串口调试助手)。
串口工具基础操作
打开烧录好 mimiclaw 的设备,在串口调试助手右下角启用终端模式,在右侧终端按下回车键,出现mimiclaw >提示符即表示可开始配置。
1. 配置 WIFI
在终端提示符后输入以下命令,替换为自身的 WiFi 名称和密码:
温馨提示:如果网络配好了但是一直连接不到请换2.4G频段修改为WPA2协议
plaintext
set_wifi <wifi名称> <wifi密码>
2. 配置 LLM 语言大模型(阶跃星辰 Step 3.5 Flash,免费)
选用阶跃星辰在 openrouter.ai 提供的免费 Step 3.5 Flash 模型,需先创建 openrouter 账号并获取 API Key:
- 访问openrouter 官网,点击右上角Sign Up完成注册;
- 注册后点击页面中央Get API Key进入控制台;
- 点击右侧Create按钮,在Name输入框为 API Key 命名,其余保持默认,再次点击Create;
- 保存生成的 API Key(仅显示一次,丢失可删除重新创建);
- 在串口调试助手终端输入以下命令,替换为获取到的 API Key:
plaintext
set_api_key <你的 api key>
3. 配置飞书机器人
步骤 1:创建飞书自建应用
登录飞书开放平台开发者后台,创建自建应用。
步骤 2:导入所需权限
- 点击应用后台的批量导出 / 导出权限按钮;
- 复制以下 JSON 权限配置,粘贴到弹出窗口中,点击下一步,确认新增权限;
- 最后点击申请开通完成权限配置。
json
{
"scopes": {
"tenant": [
"bitable:app",
"bitable:app:readonly",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"docx:document",
"docx:document.block:convert",
"docx:document:readonly",
"drive:drive",
"drive:drive:readonly",
"im:chat:readonly",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message.reactions:read",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:update",
"im:resource",
"wiki:wiki",
"wiki:wiki:readonly"
],
"user": []
}
}
步骤 3:发布机器人版本
点击应用后台左上角创建版本按钮,完成机器人版本发布。
步骤 4:获取并配置飞书凭证
- 在应用后台凭证页面获取App ID和App Secret;
- 在串口调试助手终端输入以下命令,替换为获取到的凭证信息:
plaintext
set_feishu_creds <App ID> <App Secret>
配置完成后操作
重启设备,使上述所有配置生效。
三、飞书机器人后续配置
完成设备端飞书机器人配置后,需返回飞书开放平台应用后台完成后续设置:
步骤 1:配置事件连接类型
进入应用后台事件与回调页面,将订阅方式设置为长连接。
步骤 2:添加事件订阅
在事件订阅列表中,勾选以下必需及可选事件:
表格
| 事件名称 | 事件说明 |
|---|---|
im.message.receive_v1 | 接收消息(必需) |
im.message.message_read_v1 | 消息已读回执 |
im.chat.member.bot.added_v1 | 机器人进群 |
im.chat.member.bot.deleted_v1 | 机器人被移出群 |
步骤 3:重新发布机器人版本
点击应用后台左上角创建版本按钮,发布更新后的机器人版本
完成以上所有配置后,即可在飞书中向该机器人发送消息,体验 mimiclaw 的功能。
最后
感谢陈蓝度老师的教程附链接https://hexchip.com/authors/cld1994










https://openclaw-docs.dx3n.cn/tutorials/channels/telegram
对接tg参考这个