ClawdMochi 使用说明
ClawdMochi 支持 Wi-Fi 版、有线 USB 版、蓝牙 BLE 版 三种连接方式。三种版本共用 ESP32-C3 Super Mini + ST7789 1.54 寸 240×240 屏幕硬件，主要区别在于电脑与设备之间的通信方式。
产品简介
- 用于把 Codex 会话状态映射成桌面上的实体表情
- 新版固件内置 13 种动态表情，对应
idle、thinking、reading、coding、running、delegating、planning、waiting、compacting、notify、done、error、sleep - 三种接入方案分别面向同局域网使用、USB 直连使用和蓝牙无线使用
- Codex 适配器同时提供 Windows PowerShell 版和 macOS / Linux Bash 版
- 所有资料都强调设备是被动状态指示器，不会反向阻塞 Codex 本身
适用场景
- 桌面开发时，希望不一直盯着终端也能看出 Codex 当前是否在忙
- 多窗口或多显示器工作流，需要用实体设备提示
等待确认、运行中、已完成 - 希望把 Codex 状态展示成桌宠 / 电子宠物形式
版本概览
| 版本 | 电脑到设备的连接方式 | 资料中明确的典型使用方式 |
|---|---|---|
| Wi-Fi 版 | 同一 2.4G Wi-Fi 下，通过设备 HTTP /event 接口同步状态 | 设备先网页配网，再由 Codex hook 推送状态 |
| 有线 USB 版 | USB 串口 115200，状态字逐行写入设备 | 一根数据线同时供电、传事件、烧录 |
| 蓝牙 BLE 版 | 本机桥接进程监听 127.0.0.1:49374，再经 BLE GATT 写入设备 | 后台桥接进程常驻，Codex hook 走本机 HTTP |
主要特点
- 设备端均围绕 ESP32-C3 + ST7789 屏幕设计
- 表情状态与 Codex hook 事件关联
- Codex 适配器会根据工具类型区分读取、编辑、运行、委派、计划、压缩和通知状态
done动画会保留约 5 秒后自动回到待机- 设备长时间空闲会进入
sleep
快速入口
固件下载
最新版客户交付包发布于 2026-08-08，包含 Wi-Fi、有线 USB、蓝牙 BLE 三种版本的预编译固件、图文使用教程和 Codex / Claude Code Skill：
下载地址：
https://light.buildfpga.com/clawdmochi-docs/source-files/交付客户-260808.rar
解压后先按购买版本进入 资料-wifi版/、资料-有线版/ 或 资料-蓝牙版/。每个版本目录均包含：
图文教程①·烧录版.png：Windows / macOS 一键烧录图文教程图文教程②·使用版.png：联网或连接、安装 Skill 的图文教程烧录-Windows/与烧录-macOS/：预编译固件和一键烧录工具clawd-mochi-cx/：Codex Skill 与 hooks 适配器clawd-mochi-cc/：Claude Code Skill 与 hooks 适配器
推荐首次流程
- 先确认设备使用的是 Wi-Fi 版、有线 USB 版还是蓝牙 BLE 版，并进入对应的
资料-*版/文件夹。 - 先查看其中的
图文教程①·烧录版.png，用数据线完成一键烧录。 - 再查看
图文教程②·使用版.png，按版本完成配网、USB 直连或 BLE 桥接。 - 使用 Codex 时，将完整的
clawd-mochi-cx/文件夹安装为 Codex Skill；Claude Code 则使用clawd-mochi-cc/。 - 让 Codex 按 Skill 配置 hooks，重启后在
/hooks中信任并完成测试。
附加资源
- 展示图：ClawdMochi 官方展示图
- 下载资料包：
交付客户-260808.rar