常见问题

为什么下载后里面还有三个 ZIP？

Clawd_260714.zip 是总资料包。先进入 Clawd/，再按设备连接方式解压 资料-wifi版.zip、资料-有线版.zip 或 资料-蓝牙版.zip。使用 Codex 时进入该版本的 clawd-mochi-cx/，不要误用 Claude Code 对应的 clawd-mochi-cc/。

编译时提示程序过大怎么办？

新版固件自带 13 个表情资源。请在 Arduino IDE 中把 Partition Scheme 设置为 Huge APP (3MB No OTA/1MB SPIFFS)，并保持 .ino、rle_sprite.h 和所有 sprite_*.h 位于同一个草图目录。

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

先按版本排查：

• 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 运行常驻桥接。

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

请确认使用 2026-07-14 包中同一版本的最新版 clawd-mochi-cx 脚本。新版适配器会让 done 保留约 5 秒，并过滤 Codex App 的内部辅助会话和过期事件。

补充说明

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