固件 / 安装
固件下载
客户交付包发布于 2026-08-08，包含 Wi-Fi、有线 USB、蓝牙 BLE 三种预编译固件、图文教程及 Codex / Claude Code Skill：
线上访问地址：
https://light.buildfpga.com/clawdmochi-docs/source-files/交付客户-260808.rar
解压后按购买版本选择一个文件夹：资料-wifi版/、资料-有线版/ 或 资料-蓝牙版/。请先查看其中的 图文教程①·烧录版.png；完成后继续查看 图文教程②·使用版.png 安装 Skill 并开始使用。
固件目录
| 设备版本 | 平时如何连接 | 交付包文件夹 |
|---|---|---|
| Wi-Fi 版 | 设备与电脑在同一 2.4G Wi-Fi 下 | 资料-wifi版/ |
| 有线 USB 版 | USB 数据线直连运行 Codex 的电脑 | 资料-有线版/ |
| 蓝牙 BLE 版 | 电脑通过本地蓝牙桥接控制设备 | 资料-蓝牙版/ |
每个版本目录均有 烧录-Windows/、烧录-macOS/、clawd-mochi-cx/、clawd-mochi-cc/ 与两张图文教程。本包为预编译烧录包，不需要 Arduino IDE、开发板支持包或库文件。
Windows 烧录
- 使用支持数据传输的 USB 线连接设备。
- 打开对应版本目录中的
烧录-Windows/。 - 双击
flash-windows.bat。 - 按提示选择 COM 口，等待烧录完成。
烧录时请关闭 Arduino IDE、串口监视器及其他可能占用串口的软件。
macOS 烧录
- 使用支持数据传输的 USB 线连接设备。
- 打开对应版本目录中的
烧录-macOS/。 - 推荐双击
双击烧录.command；如果系统提示无权限，先在终端执行：
chmod +x 双击烧录.command flash-mac.sh- 也可在该目录的终端中执行
bash flash-mac.sh。
首次运行可能会自动安装 esptool，需要联网与 Python 3。烧录完成后建议重新插拔设备。
使用教程与 Skill
每个版本的 图文教程②·使用版.png 都包含联网或连接、安装 Skill 和 13 种状态展示。Codex 用户安装 clawd-mochi-cx/；Claude Code 用户安装 clawd-mochi-cc/。请将完整文件夹复制到对应产品的 skills 目录，避免只复制 SKILL.md 导致其找不到 assets/ 与 references/。
Wi-Fi 版安装与更新
- 在
资料-wifi版/烧录-Windows/或资料-wifi版/烧录-macOS/中烧录 Wi-Fi 固件 - 首次开机进入
ClaWD-Mochi配网热点，密码clawd1234 - 手机访问
http://192.168.4.1完成 2.4GHz Wi-Fi 配置 - 使用
资料-wifi版/clawd-mochi-cx/完成 Codex Skill 与 hooks 配置
说明：
- Wi-Fi 凭据保存在 NVS，可在后续开机自动重连
- 切换网络可使用设备网页里的
WiFi 设置 / 换网 - 需要恢复出厂配网可使用
/wifi/forget
有线 USB 版安装与更新
- 在
资料-有线版/烧录-Windows/或资料-有线版/烧录-macOS/中烧录有线 USB 固件 - 用数据线把设备接到运行 Codex 的电脑
- 使用
资料-有线版/clawd-mochi-cx/完成 Codex Skill 与 hooks 配置
说明：
- 有线版不需要配网
- 有线版没有设备网页控制器
- Windows 脚本按
VID_303A&PID_1001自动识别并缓存 COM 端口 - 串口被其他程序占用时，脚本无法写入状态
蓝牙 BLE 版安装与更新
- 在
资料-蓝牙版/烧录-Windows/或资料-蓝牙版/烧录-macOS/中烧录蓝牙 BLE 固件 - 蓝牙版同样通过 USB 数据线烧录；蓝牙只用于日常控制
- 使用
资料-蓝牙版/clawd-mochi-cx/提供的 BLE 桥接与 Codex hooks 完成状态联动配置
说明：
- 请只使用与蓝牙版本匹配的桥接程序，避免混用旧版适配器
失败处理
常见烧录失败排查：
- 换一根支持数据传输的 USB 线
- 使用电脑直连 USB 口，不要先怀疑固件
- 必要时按住
BOOT再点按RST / RESET进入下载模式 - 确认进入的是正确的
资料-wifi版、资料-有线版或资料-蓝牙版文件夹 - 确认
firmware.bin、烧录脚本与esptool工具仍在同一个烧录-Windows或烧录-macOS目录
补充说明
- 如需更新固件，使用对应版本目录中的烧录脚本重新烧录
firmware.bin - 固件烧录后请使用同一版本目录中的 Skill 与电脑端适配器，避免混用 Wi-Fi、USB 和蓝牙版本