Clawd-on-Desk 是一个能实时感知 AI 编程助手工作状态的桌面宠物项目。它住在你的屏幕上——你提问时它思考，工具运行时它打字，子代理工作时它杂耍，审批权限时它弹卡片，任务完成时它庆祝，你离开时它睡觉。
十二种状态动画
Clawd 内置了十二套精细的动画状态，能够根据 AI 编程助手的工作状态实时切换：
- idle 发呆——眼睛跟随鼠标移动，身体倾斜，影子动态变化
- thinking 思考——头顶冒出思考气泡
- typing 敲键盘——AI 执行工具时噼里啪啦打字
- building 搞建设——三个以上会话同时跑工具时开始搬砖
- juggling 抛球——有一个子代理在工作
- conducting 指挥——两个以上子代理时挥棒当指挥家
- error 报错——显示 ERROR 大字并冒烟
- happy 开心——任务完成时蹦跳庆祝
- notification 通知——有权限请求时弹出 alert
- sweeping 打扫——PreCompact 时拿扫帚清扫
- carrying 搬东西——创建工作区时扛箱子行走
- sleeping 睡觉——60 秒无操作后打哈欠、打盹、躺下，鼠标移动时惊醒
苏米注：这个状态设计很用心，覆盖了 AI 编程助手从空闲到工作的完整生命周期，尤其是"子代理工作时杂耍"和"多个任务时指挥"的细节，让等待过程变得有趣。
迷你模式
Clawd 支持迷你模式，可以缩到屏幕右侧只露半个身子。鼠标靠近时会探头挥手，有通知或任务完成时迷你版也有专属动画。
权限弹窗集成
当 Claude Code 请求权限时，Clawd 直接在屏幕上弹出气泡，提供三个选项：
- Allow——允许当前操作
- Deny——拒绝
- 始终允许此类操作——记住选择
支持快捷键操作：Ctrl+Shift+Y 直接同意，Ctrl+Shift+N 拒绝。多个权限请求会堆叠显示，在终端回复后气泡自动消失。
实践经验：这个设计解决了 AI 编程助手的一个痛点——频繁切换终端和浏览器确认权限。直接在屏幕上处理，工作流不会被打断。
其他实用功能
- 透明区域支持穿透点击，不会遮挡工作窗口
- 记住窗口位置，重启后恢复原位
- 勿扰模式：开启后所有通知静音
- 音效系统：10 秒冷却时间，避免频繁打扰
- 系统托盘：调整大小、切换语言、检查更新
工作原理
Claude Code 集成
通过远程 hook 将状态 POST 到 localhost:23333，使用 SSH 隧道转发回本地 Clawd。权限气泡通过同一隧道完成 HTTP 往返。
Codex CLI 集成
使用独立的日志监控脚本 codex-remote-monitor.js 在远程轮询 JSONL 文件，通过隧道 POST 状态变化。远程启动命令：
node ~/.claude/hooks/codex-remote-monitor.js --port 23333远程 hook 以 CLAWD_REMOTE 模式运行，跳过 PID 采集（远程 PID 在本地无意义）。远程会话不支持终端聚焦检测。
当前限制
| 平台 | 限制 |
|---|---|
| Codex CLI | 无法检测终端跳转（靠轮询日志），Windows 钩子被硬编码关闭，轮询延迟约 1.5 秒 |
| Copilot | 权限弹窗接口未开放，无法实现 |
| Gemini | 权限弹窗接口未开放，无法检测"正在执行工具"状态 |
踩坑记录：Codex 的轮询机制导致状态更新有延迟，不适合需要实时反馈的场景。建议优先使用 Claude Code 集成。
使用体验
Clawd-on-Desk 确实能让写代码的过程更有趣。尤其是运行长任务时，看着它在屏幕上敲键盘、抛球、指挥，等待时间不再那么枯燥。透明窗口设计和权限弹窗集成是两大亮点，既不打扰工作流，又提供了必要的交互能力。
最佳实践：建议将 Clawd 放在屏幕右侧或角落，使用迷你模式。开启勿扰模式避免音效干扰，只在关键任务时关闭。