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-07-14，包含 Wi-Fi、有线 USB、蓝牙 BLE 三种版本的固件与教程：
下载地址：
https://light.buildfpga.com/clawdmochi-docs/source-files/Clawd_260714.zip
解压后先进入 Clawd/，再按设备版本打开 资料-wifi版.zip、资料-有线版.zip 或 资料-蓝牙版.zip。每个版本中：
clawd_mochi/：ESP32-C3 固件与 13 个表情资源clawd-mochi-cx/：Codex 安装脚本和教程clawd-mochi-cc/：Claude Code 安装脚本和教程
推荐首次流程
- 先确认设备使用的是 Wi-Fi 版、有线 USB 版还是蓝牙 BLE 版。
- 按资料中的接线说明连接 ST7789 与 ESP32-C3。
- 先烧录对应固件，再做配网 / USB 连接 / BLE 桥接。
- Windows 按资料安装
.cmd、.ps1与hooks.json；macOS / Linux 使用.sh与hooks.macos.json。 - 在 Codex 中执行
/hooks并信任 ClawdMochi 相关 hook。 - 用手动测试命令确认设备能正确显示
coding或done状态。
附加资源
- 展示图：ClawdMochi 官方展示图
- 下载资料包：
Clawd_260714.zip