rullerzhou-afk/clawd-on-desk

A pixel desktop pet that watches Claude Code, Codex, Cursor & other AI coding agents — so you don't have to.

什么是 Clawd on Desk？

Clawd on Desk 是一个微型桌面宠物应用（像素艺术的螃蟹、猫或云状生物），会实时监控你的 AI 编码助手（Claude Code、Copilot、Gemini、Cursor 等）的活动，并即时作出反应。当助手在思考、打字、运行工具、生成子代理或请求权限时，Clawd 会相应地动画化——你空闲时它会睡觉，子代理运行时会摇摆，权限请求时弹出可点击的权限气泡，任务完成后则会庆祝。

它支持 Windows 11、macOS 和 Linux，可通过预构建安装程序（x64/ARM64）安装，也可使用 Node.js 从源码构建。

核心功能

类别	功能
多代理支持	支持数十个 AI 编码代理（Claude Code、Codex CLI、Copilot CLI、Gemini、Cursor、Qwen、CodeWhale、Pi、OpenClaw 等）。你也可以注册一个基于 HTTP 的自定义代理。
实时动画	12 种动画状态（空闲、思考、打字、构建、子代理律动、杂耍、错误、开心、通知、清扫、搬运、睡眠）。眼睛会追踪光标；双击可戳宠物；拖拽可重新定位。
权限气泡	当代理请求权限时，Clawd 可显示一个浮动卡片，包含允许 / 拒绝 / 始终允许按钮，以及快捷键（`Ctrl+Shift+Y/N`）。支持自动批准、每次询问或仅对工具类请求询问的模式。
远程审批	可将权限请求转发至 Telegram 或 Feishu/Lark；Slack 可接收只读通知（任务完成、错误、权限提示）。
会话仪表盘与 HUD	右键 → 打开仪表盘可查看实时会话、配额，并跳转到对应终端窗口。可保持一个紧凑的 HUD 始终显示在宠物附近。
移动端伴侣（PWA）	一个基于令牌的局域网专用网页应用，可在手机上镜像桌面状态（只读）。
系统友好特性	点击穿透透明区域、记住位置、单实例锁定、通过 Claude Code 钩子自动启动、勿扰模式、音效、系统托盘菜单、通过 GitHub 发布自动更新，以及 UI 多语言支持（英文、中文、韩文、日文、葡萄牙文、西班牙文）。

如何开始

下载从 Releases 页面获取适用于你操作系统的安装程序（或克隆仓库并运行 npm install && npm run build）。
运行应用——一个像素宠物将出现在你的桌面上。
打开 设置 → 代理，点击你使用的 AI 编码工具的安装按钮（例如：npm run install:gemini-hooks）。该命令会创建相应的钩子文件（~/.gemini/settings.json、~/.copilot/hooks/hooks.json 等），使代理能向 Clawd 报告其生命周期事件。
观察宠物在你编码时的动画。当权限请求出现时，点击气泡或使用快捷键响应。
（可选）在设置 → 远程中启用 远程通知，将权限请求推送到 Telegram/Feishu，或接收 Slack 警报。
（可选）开启 移动端 / PWA，在手机上查看实时状态。

哪些人可能会喜欢？

长时间使用 AI 驱动的编码助手，希望获得视觉提示以确认后台工作仍在进行的开发者。
需要快速、一瞥式权限处理而无需切换到终端的团队。
享受一个反映 AI 代理活动的趣味桌面伴侣的任何人。

快速参考

功能	详情
支持的代理	Claude Code、Codex CLI、Copilot CLI、Gemini CLI、Antigravity、Cursor、CodeBuddy、WorkBuddy、Kiro、Kimi-CLI、Qwen、ZCode、CodeWhale、Reasonix、opencode、MiMo、Pi、OpenClaw、Hermes、Qoder、QoderWork、QwenWork、DeepSeek Harness
平台	Windows 11（x64/ARM64）、macOS、Ubuntu/Linux
语言	UI：英文 + 6 种翻译；主题可自定义（像素艺术图集）
许可证	（README 中未说明——请查看仓库）
最新版本	GitHub 发布徽章显示

Clawd on Desk 将 AI 编码代理的无形工作转化为友好、互动的桌面体验，提供视觉反馈、便捷的权限处理和可选的远程通知——同时看起来非常可爱。