Clawd on Desk
一只挂在桌面上的像素螃蟹，实时盯着 Claude Code、Codex、Cursor 等 AI 编程代理的状态——你不用一直盯屏幕，它干完了会告诉你。
积分应用以 hook 注入各代理配置（~/.claude、~/.codex 等）为主，多数集成为可选项、含卸载脚本，但自动安装的 Claude/Codex 同步属默认写入用户配置，未给最高。权限气泡提供 Ask always / 仅工具 / 自动批准三档，自动批准模式重启后自动降级，这是良好设计；但自动批准可接受未识别的请求名，扣分。数据流有专门文档（statusline 不额外请求、secrets 存本地 0600 文件、建议私有频道），透明度较好但为声明而非代码级证据。依赖固定版本并有 dependency-security-floor 测试。回滚有 uninstall/cleanup 脚本。作者、AGPL-3.0、NOTICE.md 均在。
package. 描述仍为旧版'd reacts to Claude Code'而 README 覆盖 20+ 代理，轻微不同步，扣 1。依赖范围声明合理（Node>=22.12、固定 koffi 2.16.3），postinstall 有校验脚本。CI 中失败路径与断言充分，但静态审查无法验证运行时错误消息质量。
目标场景（开发者多代理监控、桌面宠物）描述清晰、平台覆盖 Win/mac/Linux 多架构，得满分。每个代理集成的能力边界（仅状态 vs 含权限气泡）逐项注明，但大量'phase 1'限制以文字声明、无对照代码，给 2。触发精度（hook 事件映射文档 state-mapping.md）与多环境适配（WSL 限制、多显示器）有文档支持。
文档架构良好：多语言 README、docs/guides/ 专题指南、安装说明含预编译包与源码路径。许可证为完整 AGPL-3.0 文本且 package. 一致（AGPL-3.0-only），给满分。版本号 1.0.0 与 release 徽章存在但未见 CHANGELOG 文件，versioning 扣分。维护者为个人账户，带署名贡献者(@Bynlk)说明，中等。
产品输出（动画状态、会话面板、权限气泡、远程通知）对'不必盯终端'这一场景有明确边际价值，使用成本低（Electron 桌面应用，内存占用未声明，cost_benefit 扣 1）。快路径清晰。
多数功能声明可对应到 hooks/*.js 脚本、docs/guides 与 CI 中的专项测试（telegram-retirement、koffi-smoke、audit-packaged-native 等），可追溯性好但静态审查未逐文件核验实现。事实与推断基本分离，性能/稳定性类断言缺运行证据，扣分。
- 自动批准权限模式可能批准未识别的请求名，建议默认保持'始终询问'。
- 安装会写入多个代理的全局配置文件；卸载前请确认各 install/uninstall 脚本行为。
- 发布者未经认证，身份未知；使用前自行审计 hooks 目录中的安装脚本。
- Slack/Telegram/Feishu 消息可能含会话标题与路径，请使用私有频道。
- LAN PWA 桥接虽为只读+令牌，仍建议仅在可信网络启用。
- 静态审查未执行任何代码；运行时行为未经独立验证。
这个 Agent 能做什么，适合哪些场景？
Clawd on Desk 是一个开源（AGPL-3.0）的 Electron 桌面宠物应用，支持 Windows、macOS 和 Linux。它通过命令钩子、HTTP 钩子、日志轮询或插件集成，读取本地 AI 编程代理（Claude Code、Codex CLI、Copilot CLI、Gemini CLI、Cursor Agent 等二十余种）的会话状态，并驱动像素角色播放 12 种动画状态：思考、打字、子代理杂耍、报错、庆祝、睡觉等。当代理发起权限请求时，Clawd 可弹出悬浮气泡卡让你一键 Allow/Deny，也可通过 Telegram、飞书或 Slack 远程接收通知和审批。应用内置多会话仪表盘、会话 HUD、本地 Recap 统计、订阅配额显示、移动端 PWA 只读镜像，以及三套内置主题（Clawd 螃蟹、Calico 三花猫、Cloudling 云宝）和自定义主题/Codex Pet 动画包导入。安装提供 Windows x64/ARM64 安装包、macOS DMG、Linux AppImage/deb 和 Homebrew cask；Claude Code 与 Codex 的钩子在首次启动时自动注册，其余代理集成需在 Settings → Agents 中手动启用。
Clawd 运行为一个 Electron 桌面进程。对 Claude Code，它通过命令钩子加 HTTP 权限钩子做全量集成；对 Codex CLI 使用官方钩子并以 ~/.codex/sessions/ 的 JSONL 日志作为回退；对 Gemini、Qwen、Cursor、CodeBuddy、Kimi 等，通过写入各自配置文件（如 ~/.gemini/settings.、~/.cursor/hooks.、~/.qwen/settings.）注册命令钩子，也可用 npm run install:gemini-hooks 等脚本安装。它把代理的生命周期事件映射为 12 种动画状态（idle、thinking、typing、building、subagent groove、juggling、error、happy、notification、sweeping、carrying、sleeping），支持多代理并存并按会话独立追踪、取最高优先级状态显示。权限请求以右下角堆叠的气泡卡呈现，支持 Ctrl+Shift+Y / Ctrl+Shift+N 全局热键、三种处理模式（每次询问/仅问题提示/自动批准），并可通过 Telegram、飞书（Lark）做远程审批，Slack 仅推送通知。仪表盘（右键 → Open Dashboard）显示实时会话、事件和别名，可跳转到对应终端窗口；Orbit 环与 Dashboard 条展示订阅配额（本地 Claude 数据默认关闭，使用官方 status-line rate_limits 载荷）。Settings → Mobile / PWA 可生成带 token 的局域网配对链接，在手机上只读查看会话状态。自定义主题通过 node scripts/create-theme.js 脚手架创建，最少需 1 个带眼动的 SVG 加 7 个 GIF/APNG 文件，并可用 node scripts/validate-theme.js 校验。
- 跑长任务的 Claude Code 用户：启动重构或批量测试后离开电脑，等螃蟹睡觉或庆祝动画提醒回来，不必反复切回终端查看进度。
- 同时开多个代理的重度用户：Claude Code、Codex CLI、Cursor Agent 并行工作，Clawd 按会话独立追踪并用 1 个子代理戴耳机、2 个以上子代理抛球的动画区分负载。
- 在意权限安全的开发者：代理请求写文件或执行命令时，用桌面气泡或 Telegram/飞书远程一键 Allow/Deny，不必守在终端前。
- 远程/WSL 工作流用户：通过 Settings → Remote SSH 把钩子部署到远程服务器上的 Claude Code 或 Codex，本地 Clawd 仍能显示状态和权限气泡。
- 想量化自己 AI 编程使用情况的用户：用 Recap 按小时/天/月回顾已接受的代理活动，配合 Dashboard 查看订阅配额消耗。
- 主题爱好者：用
create-theme.js脚手架做出自己的角色，或直接导入已有的 Codex Pet zip 动画包。
这个 Agent 有哪些优点和局限？
- 代理覆盖面在同類项目中极为突出：除 Claude Code 和 Codex 的开箱即用集成外，还文档化了 Copilot、Gemini、Cursor、Qwen、Kiro、opencode、Hermes 等二十余种代理的具体钩子/插件接入方式。
- 权限审批是真正可操作的：桌面气泡、全局热键、Telegram/飞书远程 Allow/Deny 一应俱全，且对仅状态类代理明确保留原生权限流，不会误代决策。
- 多会话与子代理感知细腻：每个会话独立追踪，1 个子代理戴耳机、2 个以上抛球的映射让并发状态一目了然。
- 本地隐私边界清晰：Recap 只存最小化本地数据、不加遥测；移动 PWA 是 LAN-only 加 token 门控的只读镜像；Slack 密钥以 0600 权限存在本地 env 文件。
- 大量集成分阶段实现：Antigravity、Pi、CodeWhale、QoderWork、TraeCode 等是 state-only，没有权限气泡；部分集成还是实验性（DeepSeek Harness、TraeCode），采用前需查 known-limitations 表。
- 除 Claude Code 和 Codex 外，其他代理的钩子需逐个在 Settings → Agents 手动安装并保持同步，初始配置成本不低。
- Slack 渠道只能收通知，不能远程 Allow/Deny；移动 PWA 也是只读，浏览器内审批仍在路线图中。
- 从源码运行会拉取 Electron 构建工具链并生成庞大的 node_modules，仅适合贡献者或调试场景。
- Clawd 角色形象归 Anthropic 所有，属非官方粉丝项目；美术资源不受 AGPL-3.0 覆盖，二次分发需注意资产许可。
如何安装或部署这个 Agent？
普通用户从 GitHub Releases 下载预编译安装包：Windows 提供 x64 与 ARM64 的 Clawd-on-Desk-Setup-<version>-*.exe，macOS 提供 .dmg，Linux 提供 .AppImage 或 .deb。在 macOS 或 Linux x86_64 上也可用 Homebrew：brew install --cask clawd-on-desk。从源码运行需要 Node.js：git clone https://github.com/rullerzhou-afk/clawd-on-desk.git && cd clawd-on-desk && npm install && npm start。安装后首次启动会自动注册 Claude Code 与 Codex 钩子；其余代理集成需在 Settings → Agents 中按需安装。
如何使用这个 Agent？
安装并启动后，Clawd 即驻留桌面并自动同步 Claude Code / Codex 集成。要接入其他代理，右键打开 Settings… → Agents 选择对应代理安装钩子或插件。右键或托盘菜单可打开 Dashboard（实时会话）、Recap（活动回顾）、Mini Mode（贴边迷你模式）和 Do Not Disturb（免打扰）。权限气泡弹出时点击 Allow/Deny，或用 Ctrl+Shift+Y / Ctrl+Shift+N 热键；远程审批需在设置中配置 Telegram 或飞书渠道。主题更换在 Settings → Theme 中进行，可导入 Codex Pet zip 或选择自定义主题。移动端镜像在 Settings → Mobile / PWA 生成配对 URL，用手机浏览器打开即可。