产品与硬件
目前外壳采用 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
第三方扩展子板需根据实际情况验证兼容性。
多功能交互子板不附带外壳。外壳模型已开源,用户可以自行下载并打印:
主机左右两侧的扩展接口均采用 2 × 10 Pin、2.54 mm 间距的双排排母。
多功能交互子板插在左侧 H2 接口时,PIR 信号对应 GPIO4;插在右侧 H1 接口时,对应 GPIO5。PIR 采用 AS312,输出运动检测电平。开发时请根据实际插接位置选择 GPIO。
背挂充电模块按照 v1.2 的背部触点设计,可直接通过触点连接;v1.0 版本可通过 USB 接口连接。
可以,但应使用左侧 H2 接口,并核对具体摄像头的引脚、电气特性和驱动兼容性。取下官方摄像头模块前应先关机。该扩展接口采用 2 × 10 Pin、2.54 mm 间距的连接器;不能仅凭接口间距认定第三方摄像头兼容。
出货时,摄像头转轴处的螺丝被调整为提供适中阻力。如果希望摄像头打开后保持固定角度,可以适当拧紧该螺丝。
可以。所用充电宝的输出和连接方式需要满足 ESP-Mosaico 的 5 V 输入要求。
连接、配置与调试
-
确认设备已开机,并使用支持数据传输的 USB 线连接电脑。USB-C 转 USB-C 和 USB-A 转 USB-C 数据线均可使用。连接成功后,电脑应识别出对应串口,Windows 用户可在“设备管理器”中查看 COM 端口。
-
如果电脑没有设备接入提示,请重新插拔数据线并重启设备。
-
如果以上方法均无法解决问题,请前往以下页面,按照页面指引恢复出厂固件: 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 键并短按电源键即可进入。
- 先在软件栏目中选择要安装的应用并取得六位安装码。
- ESP-Mosaico 关机后,长按右下角的电源键,进入
Vibe Mode。 - 完成 Wi-Fi 配置后,点击主界面上的“下载”按钮。
- 输入六位安装码即可下载应用。
进入 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,让其参考仓库说明,引导完成后续开发流程:
欢迎前往 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 不同,需要按该项目文档学习和适配。