常见问题

下载后该进入哪个文件夹？

交付客户-260808.rar 是完整客户交付包。先按设备连接方式选择 资料-wifi版/、资料-有线版/ 或 资料-蓝牙版/，再打开其中的图文教程、Skill 和 烧录-Windows/ 或 烧录-macOS/。

烧录脚本提示找不到固件或工具怎么办？

请不要只复制单个文件。Windows 的 烧录-Windows/ 中需要同时保留 firmware.bin、esptool.exe 和 flash-windows.bat；macOS 的 烧录-macOS/ 中需要同时保留 firmware.bin、esptool.py、flash-mac.sh 与 双击烧录.command。

Skill 应该复制哪个文件？

请复制完整的 clawd-mochi-cx/ 文件夹到 Codex 的 skills 目录，不要只复制 SKILL.md。Skill 还会读取同目录的 assets/（hooks、桥接脚本）和 references/（安装与排错说明）。Claude Code 则复制完整的 clawd-mochi-cc/ 文件夹。

设备亮屏了，但完全不响应

先按版本排查：

• Wi-Fi 版：检查设备和电脑是否在同一网络，先访问 /state
• 有线版：检查是否用了充电线而不是数据线
• 蓝牙版：检查桥接进程是否已经启动并连接设备

为什么改了 hooks.json 之后就不生效了？

Codex 会把修改过的 hook 标记为未信任。合并配置后需要重启 Codex，再执行 /hooks 并重新信任。

为什么按 Esc 中断后表情没有立刻变化？

Codex 中断时不一定发出可用 hook，因此设备会停留在上一个状态，直到下一次事件到来或超时恢复。

Wi-Fi 版为什么必须 2.4GHz？

ESP32-C3 只支持 2.4GHz，且建议使用 ASCII SSID，避免中文热点名导致连接失败。

蓝牙版为什么还要跑一个本地桥接？

因为 BLE 版采用本地 127.0.0.1:49374 桥接，把 HTTP 请求转换成 GATT 写入，避免每次事件都重新握手蓝牙连接。

有线版为什么插上后还没反应？

常见原因在资料里列得比较清楚：

• 用了充电线
• 串口被别的软件占用
• USB CDC On Boot 没启用
• hooks 没有信任

Wi-Fi 版能不能不记设备 IP？

可以使用 clawd-mochi.local，但 Windows 上反复解析 .local 可能产生明显延迟。新版资料推荐把数字 IP 写入 ~/.codex/hooks/clawd-mochi.url。

蓝牙版桥接为什么建议常驻？

主要原因是：

• 保持 BLE 长连接，避免事件发送时 1 到 3 秒的握手延迟
• hook 只需要打本机 HTTP，不拖慢 Codex

有线版 / 蓝牙版有没有手机网页控制器？

说明如下：

• Wi-Fi 版有网页控制器
• 有线版和蓝牙版没有同等的手机网页控制器
• 这两个版本主要通过 face:、bg:、light: 命令做待机自定义

macOS / Linux 还需要 PowerShell 吗？

不需要。新版三种 Codex 资料均提供 clawd-mochi-codex.sh 与 hooks.macos.json。BLE 版仍需 Python 3.9+ 与 bleak 运行常驻桥接。

为什么完成动画一下就消失或结束后闪烁？

请确认烧录了与设备匹配的 Wi-Fi、USB 或蓝牙固件，并使用与该版本匹配的电脑端适配器。

补充说明

• 如需售后支持，请以购买渠道或实际提供的服务方式为准