Mosaico 出厂固件（ESP-Claw）

这是 ESP-Mosaico 的出厂应用固件，基于 ESP-Claw 构建，将 AI Agent、触屏应用和板载外设整合到同一套界面中。适用于 ESP32-S31 版 ESP-Mosaico，版本为 0.3.1。

功能

• 480×480 触屏界面，包含天气、相机、相册、设置和蓝牙音频等应用。
• ESP-Claw Agent Runtime，支持对话、记忆、技能、Lua 扩展和 MCP 能力。
• Wi-Fi 配网、网页配置和网络服务接入。
• 适配板载摄像头、音频、传感器及 NAND 文件存储。
• 支持保留式 Recovery；本地必要初始化成功后确认新固件启动，无需等待联网成功。

硬件与使用

使用配备 16 MiB Flash、PSRAM、480×480 触屏及 NAND 存储的 ESP32-S31 ESP-Mosaico 开发板，通过 USB 供电。

安装完成后默认进入 Claw 主界面，点击应用图标使用相机、相册、音频和设置等功能。在设置中配置 Wi-Fi；AI、天气等在线功能还需相应的网络和服务配置。AI 模型服务凭据由用户自行配置，离线时可使用本地功能。

需要重新安装应用时，按住顶部 GPIO7 按键并复位进入 Recovery，再按平台的安装流程操作。GPIO7 是恢复入口，与 ROM 下载按键不同。

安装与兼容性

本平台固件包包含工程分区表、Claw 应用、UI 资源和 SYSTEM 资源，面向 Recovery 0.1.2 或更新的兼容版本，使用保留前 2 MiB 系统区域的布局。Recovery 和 bootloader 由平台的系统固件流程管理，不包含在本应用更新包中。

经现有兼容 Recovery 更新时，不主动擦除 NVS、sysmeta 或 NAND，也不自动迁移旧版 NVS 配置。首次迁移旧布局请按工程的完整安装流程操作；完整安装会初始化 NVS、sysmeta 和启动选择。应用首次启动可能向 NAND 同步随固件提供的预置文件。

本应用保留原有控制台，不接入应用侧 ESP-Iris。Iris 工具在写入后可能无法收到应用健康消息；请结合设备界面和后续正常重启确认启动结果。

验证情况与限制

已完成 ESP32-S31 构建、镜像哈希及分区检查、17 项自动测试，并通过 USB Recovery 更新写入及读回校验。真机已确认显示 Claw 主界面和 GPIO7 进入 Recovery。首次启动失败回退及完整外设回归尚未完成，不将这些项目标记为已通过。

本版本面向 ESP32-S31 ESP-Mosaico，不声明兼容其他开发板。部分在线功能依赖用户的网络、服务账号和配置。

许可

工程源码采用 Apache-2.0；ESP-Claw、其他第三方依赖及素材遵循各自许可证。封面为本工程主界面截图。