Clawd on Desk
一只挂在桌面上的像素螃蟹，实时盯着 Claude Code、Codex、Cursor 等 AI 编程代理的状态——你不用一直盯屏幕，它干完了会告诉你。
- Star 数
- ★ 6.5k
- 最近更新
- 1 天前
- License
- AGPL-3.0
- 主语言
- JavaScript
- FA 评分
- 73/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 跑长任务的 Claude Code 用户：启动重构或批量测试后离开电脑，等螃蟹睡觉或庆祝动画提醒回来，不必反复切回终端查看进度。
- 不适合
- 需要完全离线或禁止本地代理状态外发的团队
- 只想要纯命令行、无 GUI 桌面的用户
- 需要 Trae 国际版或 Linux 版千问办公支持的用户
- 源码审查
- 73/100 · 存在缺口
这个 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.json、~/.cursor/hooks.json、~/.qwen/settings.json）注册命令钩子，也可用 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？
普通用户从 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，用手机浏览器打开即可。
这个 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 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Clawd on Desk 当前 | 73 · 存在缺口 | 桌面应用免费 | ★ 6.5k | 1 天前 | JavaScript | Codex · Claude Code |
| T3 Code | 52 · 缺口较多 | — | ★ 30k | 今天 | TypeScript | Codex · Claude Code |
| Peon Ping——AI 代理语音通知 | 50 · 缺口较多 | 命令行工具免费 | ★ 5.1k | 5 天前 | Shell | Codex · Claude Code |
| Better Harness | 85 · 表现良好 | Agent 插件 / 技能免费 | ★ 2.4k | 5 天前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
积分应用以 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 桥接虽为只读+令牌，仍建议仅在可信网络启用。
- 静态审查未执行任何代码；运行时行为未经独立验证。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
v1.4.0 Clawd v1.4.0 reorganizes Settings into five focused tabs, reduces idle CPU use with sleep-aware rendering, and adds KiroCrew and Qoder CN integrations. It also adds opt-in external permission review, read-only phone approval summaries, local OpenCode/MiMo question answers, and herdr pane focus. Settings - Five-tab Settings redesign (#1218, #1220, #1179; related #969) — splits General into General, Pet, Notifications, Sessions, and Permissions & approval; moves Remote approval into the Permissions & approval tab with On this machine, …在 GitHub 查看 ↗ -
发布说明摘录
v1.3.0 Clawd v1.3.0 improves how the pet follows Claude Code tool batches, Codex compaction and approval routing, and WorkBuddy conversations. DeepSeek Harness gains desktop support alongside its web integration. This release also adds optional quota reminders and improves session history, official theme downloads, pet sizing, Footprints, and Linux AppImage shutdown. Claude Code - Thinking between tool batches (#1123, #1150, #1153, #1154; issue #1018) — returns the pet to thinking after a correlated tool batch, instead of typing …在 GitHub 查看 ↗ -
发布说明摘录
v1.2.0 Clawd v1.2.0 adds experimental MiniMax Code support, OpenCode 2.x permissions, DeepSeek Harness session details, safer optional approval automation, and new theme behavior. Idle bubbles in the built-in Clawd theme now mirror on the right half of the screen, where the pet appears by default. This release also improves session recovery, hook health, notifications, and remote Codex monitoring. Agents And Sessions - MiniMax Code (#1038, #1049) — adds an experimental, state-only integration through Clawd's managed local plugin at ~/.minimax/plugins/clawd-state. …在 GitHub 查看 ↗