固件 / 安装

固件下载

最新版发布于 2026-07-14，包含 Wi-Fi、有线 USB、蓝牙 BLE 三种版本的固件与教程：

• 下载 ClawdMochi 固件与教程资料包（2026-07-14）

线上访问地址：

• https://light.buildfpga.com/clawdmochi-docs/source-files/Clawd_260714.zip

解压顺序：先解压 Clawd_260714.zip，进入 Clawd/，再解压需要的 资料-wifi版.zip、资料-有线版.zip 或 资料-蓝牙版.zip。面向 Codex 的电脑端文件位于各版本的 clawd-mochi-cx/assets/。

所需工具

通用工具包括：

• Arduino IDE 2.x 或 arduino-cli
• ESP32 开发板支持包
• Adafruit GFX Library
• Adafruit ST7735 and ST7789 Library
• 支持数据传输的 USB 线

蓝牙 BLE 版额外需要：

• NimBLE-Arduino 2.x（h2zero）
• Python 3.9+
• bleak

固件位置

通用板卡设置

建议板卡设置如下：

说明：

• 新版内含 13 个表情资源，默认分区可能装不下，必须选择 Huge APP
• 有线版的 USB CDC On Boot 必须启用；Wi-Fi 与 BLE 版也建议启用以便查看日志
• 不要拆散草图目录；.ino、rle_sprite.h 和全部 sprite_*.h 必须放在一起

Wi-Fi 版安装与更新

1. 烧录 Wi-Fi 版 clawd_mochi.ino
2. 首次开机进入 ClaWD-Mochi 配网热点，密码 clawd1234
3. 手机访问 http://192.168.4.1 完成 2.4GHz Wi-Fi 配置
4. Windows：把 .cmd、.ps1、hooks.json 复制到 %USERPROFILE%\.codex\hooks\
5. Windows：将 hooks.json 的 hooks 对象合并到 %USERPROFILE%\.codex\hooks.json，并替换 __HOOKS_DIR__
6. macOS / Linux：改用 clawd-mochi-codex.sh 与 hooks.macos.json
7. 将设备 URL（建议 Windows 使用数字 IP）写入 ~/.codex/hooks/clawd-mochi.url
8. 重启 Codex，执行 /hooks 并信任

说明：

• Wi-Fi 凭据保存在 NVS，可在后续开机自动重连
• 切换网络可使用设备网页里的 WiFi 设置 / 换网
• 需要恢复出厂配网可使用 /wifi/forget

有线 USB 版安装与更新

1. 烧录有线 USB 版固件
2. 用数据线把设备接到运行 Codex 的电脑
3. Windows：将 .cmd、.ps1 和 hooks.json 复制到 %USERPROFILE%\.codex\hooks\
4. macOS / Linux：改用 clawd-mochi-codex.sh 与 hooks.macos.json
5. 合并 hooks 配置后重启 Codex，再执行 /hooks 信任

说明：

• 有线版不需要配网
• 有线版没有设备网页控制器
• Windows 脚本按 VID_303A&PID_1001 自动识别并缓存 COM 端口
• 串口被其他程序占用时，脚本无法写入状态

蓝牙 BLE 版安装与更新

1. 烧录蓝牙 BLE 版固件
2. 安装 bleak

pip install bleak

1. Windows 将 clawd-mochi-cx/assets/ 中的全部文件复制到 %USERPROFILE%\.codex\hooks\
2. 准备并启动桥接：

• clawd-mochi-ble-bridge.py
• clawd-mochi-bridge-silent.vbs
• start-bridge.cmd
• macOS / Linux 使用 start-bridge.sh

1. 确认桥接日志出现 BLE connected；桥接会监听 127.0.0.1:49374
2. 合并 hooks.json；macOS / Linux 改用 .sh 与 hooks.macos.json
3. 重启 Codex，在 /hooks 中信任

说明：

• Windows 可将 clawd-mochi-bridge-silent.vbs 放入 shell:startup 实现静默自启
• macOS 可用 start-bridge.sh install 安装登录自启；Linux 可配置 systemd --user
• 桥接负责长期保持 BLE 连接，hook 只发本机 HTTP 请求

失败处理

常见烧录失败排查：

• 换一根支持数据传输的 USB 线
• 使用电脑直连 USB 口，不要先怀疑固件
• 必要时按住 BOOT 再点按 RST / RESET 进入下载模式
• 重新检查是否选对 ESP32C3 Dev Module
• 编译提示程序过大时，将 Partition Scheme 改为 Huge APP
• 缺少 sprite_idle.h 时，恢复完整的 clawd_mochi/ 草图目录
• BLE 编译缺少 NimBLEDevice.h 时，安装 NimBLE-Arduino 2.x

补充说明

• 如需更新固件，可重新烧录对应版本的 clawd_mochi.ino
• 烧录后请继续使用同一版本包内的最新版 clawd-mochi-cx 脚本，避免固件与旧 hooks 适配器混用