clawd-on-desk

你的AI编程助手旁边，有一只像素小螃蟹在「上班」

想象一下这个画面：你正在让 Claude Code 帮你重构一个复杂模块，屏幕角落有一只蠢萌的像素螃蟹——你在思考时它发呆，你开始打字时它跟着敲键盘，子智能体启动时它戴上耳机摇头晃脑，权限弹窗出现时它举手提示，任务完成时它原地蹦迪庆祝。你不在电脑前的时候，它就趴在那儿打瞌睡。

这就是 Clawd on Desk，一款运行在桌面上的像素桌面宠物，专门「围观」你的 AI 编程工具在干什么。

背景故事：桌面上需要「存在感」

AI 编程工具越来越强大，但它们本质上是无形的——你看不到它们在思考、在忙碌还是在等待。当你在另一个窗口工作时，你甚至不知道 Claude Code 是否还在运行、是否卡住了。Clawd 的作者 rullerzhou 发现，用户真正需要的不只是结果，而是一种「在场感」——知道 AI 正在做什么。

这种需求类似于游戏里的 NPC 跟随、IDE 里的状态指示灯，但 Clawd 用一种更轻松、更人格化的方式来实现。它不告诉你具体的代码行数，而是用一只会睡觉、会打哈欠、会摇头的螃蟹，让你感受到工作的节奏。

技术实现：Hooks 驱动的实时感知

Clawd 的核心技术是命令钩子（Command Hooks）和日志轮询。当你启动一个支持的 AI 编程工具时，Clawd 会自动注入对应的 Hook 脚本，这些脚本会在每个命令执行时向 Clawd 发送状态信号。支持的工具包括：

• Claude Code — 命令钩子 + HTTP 权限钩子（完整集成）
• Codex CLI — 官方 Hook + JSONL 回退（~/.codex/sessions/ 日志轮询）
• Copilot CLI / Gemini CLI / Cursor Agent — 命令钩子自动注册
• Kiro CLI / Kimi CLI / Qwen Code / opencode — 各平台原生 Hook 集成
• Pi / OpenClaw / Hermes Agent — 插件式集成

12 种 AI 编程工具，意味着 Clawd 是一个高度通用的事件聚合器。它的状态机定义了 12 种动画状态：发呆、思考、打字、构建、子智能体摇头晃脑、多个子智能体抛球、报错、庆祝、通知、打扫、搬运、打盹。每种状态由事件触发器驱动，形成「AI动作 -> Hook信号 -> 状态切换 -> 动画播放」的闭环。

权限气泡：把终端弹窗变成桌面卡片

传统 AI 编程工具的权限请求发生在终端里，有时会阻塞流程，有时用户根本没注意到。Clawd 将这些权限请求弹出为桌面浮动卡片，支持一键 Allow / Deny / Always-allow，并可通过全局快捷键批准或拒绝。多个权限请求会向上堆叠，自动消失机制确保终端里的操作和桌面卡片不会冲突。

会话仪表盘：多会话一目了然

Clawd 内置了一个会话仪表盘（Dashboard），可以查看所有活动会话、实时事件流、会话别名，并支持跳转到对应终端窗口。进程存活检测会自动清理孤儿会话，启动恢复机制确保 Clawd 重启后能感知到仍在运行的 AI 工具。紧凑型 HUD 可以始终显示当前活跃的会话数量和状态。

代码架构：Electron + 事件驱动状态机

Clawd 基于 Electron 构建，源码分为 src/（约 100+ 个 JS 模块）、assets/（动画帧、图标、声音）、hooks/（各平台 Hook 安装脚本）、themes/（主题包）、extensions/（插件系统）。核心架构是事件驱动的状态机：

• agent-gate.js — 各 AI 工具的事件接入网关
• state.js — 全局状态管理，解析 Hook 信号并映射到动画状态
• bubble-renderer.js — 权限气泡渲染
• session-hud.js — HUD 组件
• theme-runtime.js — 主题加载与动画适配

内置三个主题：Clawd（像素螃蟹）、Calico（三花猫）、Cloudling（云宝），还支持导入 Codex Pet 动画包。代码质量较高，测试覆盖率完整，多语言支持体现了全球化产品思维。

上手体验：5分钟就能用上

Clawd 的使用门槛极低：

• 非技术用户：直接下载对应平台的安装包（Windows x64/ARM64、macOS、Linux AppImage/deb），双击安装即可
• 源码构建：需要 Node.js >= 18，执行 npm install && npm start，Hook 自动注册

内存占用约 512MB，磁盘占用 200MB，不需要 GPU。是一款真正的「零配置」桌面伴侣工具。

争议与局限

Clawd 本质上是一个装饰性工具——它不提升 AI 编程的效率，只是提供状态可视化。对于追求极致效率的开发者来说，额外的图形渲染反而是资源消耗。此外，作为 Electron 应用，它的内存占用比原生桌面应用高，且动画效果在低配置机器上可能出现卡顿。

另一个潜在风险是隐私：Clawd 需要读取各 AI 工具的会话日志和 Hook 信号，对于处理敏感代码的用户，需要评估日志文件暴露程度。

行业意义：AI 工具的「人格化」趋势

Clawd 代表了一个有趣的趋势：AI 工具的人格化。从 GitHub Copilot 的 Copilot Labs 到 Claude Code 的对话界面，AI 编程工具正在从「黑盒服务」向「有温度的助手」演进。Clawd 用最低技术成本实现了这种人格化——不需要改变任何 AI 工具的代码，只需要「围观」它们的工作状态。

截至分析时，Clawd 获得了 3587 颗星，在 GitHub trending 上多次出现，被 awesome-claude-code 等社区列表收录。其多语言文档（中文、繁体、英文、日文、韩文）覆盖了主要开发者群体。