Mimiclaw 快速体验指南

mimiclaw 是 openclaw 的衍生项目.

mimiclaw 使用 C语言 编程, 基于 esp-idf 实现.

所以 mimiclaw 可以运行在 esp-idf 支持的所有硬件上.

烧录固件

准备一个 8 MB PSRAM 和 16 MB flash 的 esp32 或者 esp32-s3 设备
将设备连接到电脑上
请点击下列图标, 使用 espressif 官方 提供的 ESP Launchpad 来烧录固件.
点击网页右上角的 Connect 按钮连接设备, 然后再点击左下角的 Flash 按钮开始烧录.
之后会自动下载固件, 会消耗大概1分钟时间，下载完成会自动跳转到 Console 页面显示烧录进度.

配置 mimiclaw

我们需要为 mimiclaw 进行下列配置：

提供 WIFI
提供 LLM(语言大模型)
提供飞书机器人

你需要一个 串口调试工具 来与设备进行交互. 我目前使用的是 microsoft Store(windows 的应用商店) 中下载的 串口调试助手:

serial_debuger

以串口调试助手为例，打开烧录好 mimiclaw 的设备

在界面的右下角启用终端模式，然后在界面右侧的终端按下回车键，会显示 mimiclaw >

配置 WIFI

在终端中输入

set_wifi <wifi名称> <wifi密码>

使用阶跃星辰的 Step 3.5 Flash(目前免费)

阶跃星辰目前在 openrouter 上提供了免费的 Step 3.5 Flash 语言大模型.

所以我们需要创建一个 openrouter 账号来薅羊毛, 访问官网进行注册: https://openrouter.ai.

进入 openrouter 官网后点击右上角的 Sign Up 弹出注册页面

openrouter_signup

注册完成后, 点击页面中央的 Get API Key 按钮, 跳转到控制台页面.

openrouter_get_apikey_1

然后再点击右侧的 Create 按钮.

openrouter_get_apikey_2

在 Name 输入框为你的 API Key 取个名字，其他保持默认，然后点击 Create 按钮即可.

openrouter_get_apikey_3

保存好你的 API Key, 这只会显示一次. 当然如果丢失的话也没事，删了重新创建即可.

openrouter_get_apikey_4

在串口调试助手的终端中输入

set_api_key <你的 api key>

创建飞书机器人

在飞书开放平台登录开发者后台，并创建自建应用

导入所需权限

点击如下图所示的 批量导出/导出权限 按钮

feishu_bot_1

复制下列 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": []
    }
}

粘贴 json 进弹出的窗口后点击右下角 下一步，确认新增权限

feishu_bot_2

最后点击 申请开通 按钮即可

feishu_bot_3

发布机器人版本

点击页面左上角的 创建版本 按钮，发布机器人版本
在凭证页面获取 App ID 和 App Secret
为 mimiclaw 设置飞书机器人凭证

在串口调试助手的终端中输入
```
set_feishu_creds <App ID> <App Secret>
```

mimiclaw 配置完成！

重启设备!!!

配置飞书机器人

配置事件连接类型

在飞书开放平台的应用后台，进入 事件与回调 页面：

设置订阅方式为 长连接

feishu_bot_8

添加事件订阅

勾选以下事件：

事件	说明
`im.message.receive_v1`	接收消息（必需）
`im.message.message_read_v1`	消息已读回执
`im.chat.member.bot.added_v1`	机器人进群
`im.chat.member.bot.deleted_v1`	机器人被移出群

feishu_bot_5

再次发布机器人版本

点击页面左上角的 创建版本 按钮，发布机器人版本

feishu_bot_6

好了，快使用飞书和 mimiclaw 发消息试试吧!

Menu