产品与硬件

目前外壳采用 3D 打印工艺,可能存在微小变形等外观瑕疵,但不影响正常使用。为尽快交付给开发者,当前版本暂未开模,后续计划推出开模版本,进一步提升外观品质。

3D 外壳模型已开源,可自行打印和 DIY:https://makerworld.com/zh/@ESP_MOSAICO

是的。当前主机板载 1 个麦克风,并标配扬声器,可用于采集和播放音频。

主体内置 65 mAh 锂电池。在测试条件下,仅亮屏续航约 15 分钟;开启 Wi-Fi 并亮屏约 10 分钟;同时开启 Wi-Fi、屏幕和摄像头约 5 分钟。实际续航会因使用场景而异。

如需延长续航,可搭配背挂充电模块。

包含。当前套装标配官方 SC101IOT DVP 摄像头扩展子板。该摄像头是独立模块,并非主机板载摄像头。

是的。ESP-Mosaico 主板配有 128 MB NAND Flash。

设备内部使用两颗地磁传感器组成检测矩阵,可识别四个方向的磁吸状态。

主机(Core Unit)重量约为 31.7 g。

设备共有三个物理按键:USB 接口右侧为电源键,左侧为 BOOT 键,顶部右侧为 AI 功能键。

支持。ESP-Mosaico 搭载的 ESP32-S31 在硬件上支持经典蓝牙(BR/EDR)和 Bluetooth 5.4 低功耗蓝牙(BLE)。

但硬件支持不代表所有固件都会提供配对界面或完整的蓝牙 Profile,具体可用功能取决于所使用的固件。

采用 SC101IOT 的 ESP-Mosaico 摄像头有两款镜头,外观尺寸略有不同。请以模组编号确认光学参数:

  • AS-AGT08AI101D4-21:焦距 4.3 mm,光圈 F2.4。
  • AS-AGTO08AI101D4-21-V2.0(最新版):焦距 3.1 mm,光圈 F1.8。

图像规格方面,SC101IOT 为 100 万像素传感器,最大传输规格为 8-bit、1280 × 720 @ 30 FPS。

详细参数见 ESP-Mosaico 摄像头模块用户指南。

橙灯表示正在充电,白灯表示已经充满。

扩展模块与配件

电池容量约为 1000 mAh,可用于延长 ESP-Mosaico 的续航时间。

目前摄像头模块仅支持插入左侧,支持热插,但不支持热拔。如误插到右侧,请先关机,再拔下模块并插到左侧,然后重新开机。

其他扩展模块的兼容性请参考:

https://github.com/esp-mosaico/esp-mosaico-bsp#expansion-modules

第三方扩展子板需根据实际情况验证兼容性。

多功能交互子板不附带外壳。外壳模型已开源,用户可以自行下载并打印:

https://makerworld.com.cn/zh/models/3012963-esp-mosaico-mo-kuai-jiao-hu?appSharePlatform=copy#profileId-3539338

主机左右两侧的扩展接口均采用 2 × 10 Pin、2.54 mm 间距的双排排母。

多功能交互子板插在左侧 H2 接口时,PIR 信号对应 GPIO4;插在右侧 H1 接口时,对应 GPIO5。PIR 采用 AS312,输出运动检测电平。开发时请根据实际插接位置选择 GPIO。

详细说明:https://docs.espressif.com/projects/esp-dev-kits/zh_CN/latest/esp32s31/esp-mosaico/user_guide_interact.html#esp-mosaico

背挂充电模块按照 v1.2 的背部触点设计,可直接通过触点连接;v1.0 版本可通过 USB 接口连接。

可以,但应使用左侧 H2 接口,并核对具体摄像头的引脚、电气特性和驱动兼容性。取下官方摄像头模块前应先关机。该扩展接口采用 2 × 10 Pin、2.54 mm 间距的连接器;不能仅凭接口间距认定第三方摄像头兼容。

出货时,摄像头转轴处的螺丝被调整为提供适中阻力。如果希望摄像头打开后保持固定角度,可以适当拧紧该螺丝。

可以。所用充电宝的输出和连接方式需要满足 ESP-Mosaico 的 5 V 输入要求。

连接、配置与调试

  1. 确认设备已开机,并使用支持数据传输的 USB 线连接电脑。USB-C 转 USB-C 和 USB-A 转 USB-C 数据线均可使用。连接成功后,电脑应识别出对应串口,Windows 用户可在“设备管理器”中查看 COM 端口。

  2. 如果电脑没有设备接入提示,请重新插拔数据线并重启设备。

  3. 如果以上方法均无法解决问题,请前往以下页面,按照页面指引恢复出厂固件: https://mosaico.ai/zh-hans/firmware

  • 设备尚未配网:连接设备发出的 Wi-Fi 热点,然后在浏览器中访问 http://192.168.4.1。

  • 设备已配网:确保手机或电脑与 ESP-Mosaico 连接到同一局域网,然后在浏览器中访问设备的局域网 IP 地址。

可先在设备的 Settings > Network 页面连接 Wi-Fi,再前往 Settings > AI Model 查看设备 IP 地址,也可以用手机扫描 IP 地址旁的二维码直接访问。

可以通过设备右侧扩展接口中的 UART(TX/RX)引脚查看串口日志。

需要。在 Mosaico-Claw Idea 中通过 Settings > AI Model 进入控制面板;修改模型或其他控制面板设置后,请手动重启 ESP-Mosaico,使新配置生效。

固件、模式与恢复

ESP-Mosaico 出厂时已预装 Mosaico-Claw。若该应用被您自行开发的应用覆盖,可前往 Mosaico-Claw 详情页重新安装。

设备关机后,按住左下角的 BOOT 键,再短按右下角的电源键。进入下载模式后,屏幕保持黑屏属于正常现象。

不一定。ESP-Mosaico 主固件基于 ESP-Claw 开发,但两者使用独立的版本号,不要求保持一致。请分别核对目标固件版本及升级后的实际运行情况,不能仅凭版本号不同判断升级失败。

可在 Vibe Mode 中切换已安装的应用。进入方法如下:设备关机时,按住顶部的 AI Button,再短按右下角的 Power Button;屏幕显示“mosaico”后,松开 AI Button。

若应用列表中没有 Mosaico-Claw,可前往 Mosaico-Claw 详情页安装,或输入六位编码“100000”进行安装。

ESP-Claw 中的 Lua/Skill 扩展属于另一种开发方式,其安装和退出机制与原生固件不同。

Vibe Mode 用于应用安装与维护,Recovery 是其底层保留固件的技术名称。设备已安装 Vibe Mode 固件时,可按住 AI 键并开机进入 Vibe Mode。

BOOT 下载模式即芯片的 ROM 下载模式,用于通过 USB 进行底层固件烧录。设备关机后,按住 BOOT 键并短按电源键即可进入。

  1. 先在软件栏目中选择要安装的应用并取得六位安装码。
  2. ESP-Mosaico 关机后,长按右下角的电源键,进入 Vibe Mode。
  3. 完成 Wi-Fi 配置后,点击主界面上的“下载”按钮。
  4. 输入六位安装码即可下载应用。

进入 Vibe Mode,依次选择 Develop > Save Current Build。保存后,当前运行的 Idea 会显示在 Vibe Mode 中,之后可以再次打开或管理,无需先上传到 mosaico.ai。

进入 Vibe Mode 的设置界面,关闭触觉反馈选项即可。

ESP-Claw 与 AI 服务

支持,但并非原生内置功能,需要刷入适配固件。使用前需准备 Muse 账号和 SDK Token,并确保所在地区及网络环境支持 Muse 服务。

ESP-Claw 应用运行在 ESP-Mosaico 设备中;大语言模型运行在所配置的模型服务商服务器上,设备通过网络调用模型服务。

在 IM 中发送 /session new 即可开启新会话。默认情况下,IM 会沿用当前会话;长时间使用同一会话后,较早的对话内容可能会被遗忘。

相关说明:https://esp-claw.com/zh-cn/tutorial/first-interactions/

可以,但自建服务需要提供 ESP-Claw 所支持的兼容接口,例如 OpenAI 或 Anthropic 兼容接口。请填写对应的服务地址、模型名称和 API Key,并确保设备能够访问该服务。

模型运行在提供接口的服务器上,并非部署在 ESP-Mosaico 设备中。

不能。出厂固件只能直接使用已适配的语音识别服务。若要接入其他服务商,需要修改源码,实现相应的鉴权、音频传输和识别结果处理,并重新编译和验证固件。

语音识别(ASR)接口不能直接套用大语言模型的兼容接口。

不会。刷入其他固件不会清空随 ESP-Mosaico 提供的体验额度。重新安装 Mosaico-Claw Idea 后可以继续使用。

当前额度有日限额和周限额。如果体验额度已经用尽,需要配置自己的模型凭据。

开发资源与社区

  • .irisfw 格式:需基于 Vibe Mode v0.2 或更高版本开发。审核通过后,系统会生成 6 位安装码,用户可直接在设备上输入该安装码安装应用。

  • .bin 和 .zip 格式:暂无其他格式要求。此类附件不会生成 6 位安装码,用户需自行下载后安装。

使用支持数据传输的 USB 线将 ESP-Mosaico 连接到电脑,并按下右下角的电源键开机。然后将 esp-mosaico-vibe 仓库链接发送给电脑端的 Coding Agent,让其参考仓库说明,引导完成后续开发流程:

https://github.com/esp-mosaico/esp-mosaico-vibe

欢迎前往 ESP-Mosaico 社区讨论区参与技术交流。

先将固件打包为 .irisfw 文件,再在 mosaico.ai 社区上传固件时选择“添加 Iris 固件”,附上文件并完成提交。普通 .bin 文件不能通过修改扩展名转换为 Iris 固件包。

使用无线更新时,目标设备需要已安装并运行 Vibe Mode 固件。上传完成不等于审核通过,请继续查看实际提交和审核状态。

源码仓库位于:

https://github.com/esp-mosaico/esp-mosaico-claw

如需自行编译,请根据所选源码版本的 README 和依赖说明准备 ESP-IDF 环境,并拉取所需子模块。

需要。请使用包含相应硬件适配的 BSP 版本,由 BSP 识别硬件版本并处理两者之间的差异。

Chat Coding 在 ESP-Mosaico 上通过文字或语音与 ESP-Claw 交互,用于创建技能、Lua 功能和自动化。Vibe Coding 则在电脑端使用 AI 编程 Agent,配合模拟器、调试工具和实体 ESP-Mosaico 开发嵌入式应用。

不能直接通过 ESP-Claw 修改。修改出厂主页中的原生 App,需要修改对应源码。

不需要。自行开发的应用可以直接烧录到自己的 ESP-Mosaico;只有将应用上传到应用社区时才需要经过社区审核。

可以参考乐鑫的 ESP-Vision 项目:https://vision.espressif.com/。其开发方式与 Vibe Coding 不同,需要按该项目文档学习和适配。