开源 Agent 桌宠 Clawd on Desk：让 Claude Code 的状态从终端‘蹦‘到桌面

Clawd on Desk — AI 智能体桌面宠物

我养了一只螃蟹，它能帮我看代码——Clawd on Desk 桌宠体验
开源 Agent 桌宠 Clawd on Desk：让 Claude Code 的状态从终端’蹦’到桌面

Clawd on Desk 是一款开源的像素风 AI 桌面宠物🦀，能实时感知 Claude Code、Cursor、Codex 等 14+种编程助手的工作状态——思考、打字、构建、报错，每种状态都有对应的动画，让你不再需要盯着终端。更实用的是，它的权限审批气泡能让你直接在桌面一键处理终端请求，不用频繁切换窗口，本文带你从安装到上手，把这只会看代码的螃蟹领上桌面。

“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（简称 Clawd）是一款基于 Electron 构建的开源像素风桌面宠物应用。不同于传统桌宠单纯卖萌，Clawd 的核心能力是实时可视化 AI 编程助手的工作状态——思考、打字、构建、报错、等待权限审批……每种状态都有对应的动画表现。

由开发者Ruller于 2025 年 3 月启动，截至目前已获得3.7k stars，被收录于 Awesome Claude Code，最新版本v0.8.1（2026 年 5 月 27 日发布）。

核心功能

🤖 多 Agent 实时感知（14+ 种工具）

Clawd 通过读取各 AI 编程工具的hooks / 插件 / 日志来感知状态变化，无需额外配置即可自动识别已安装的 Agent：

🎬 12 种动画状态

Clawd 会根据 AI Agent 的运行状态切换动画，让终端里发生的一切"可视化"：

状态	触发条件	表现
空闲	无 Agent 运行或所有 Agent 静默	眼睛随鼠标移动，身体微倾
思考	Agent 正在推理 / 分析	托腮沉思状
打字	Agent 正在输出代码	敲键盘动画
构建	Agent 执行命令 / 构建中	敲击/施工动画
子代理	单个子代理运行中	单手抛接
多子代理	多个子代理并行	双手杂耍抛接
错误	Agent 报错或命令失败	惊慌/炸毛
开心	任务成功完成	庆祝跳跃
通知	收到权限请求	举手提示
扫地	Agent 空闲清理	扫帚扫地
搬运	文件操作 / 数据传输	搬箱子
睡眠	60 秒以上无任何 Agent 活动	打哈欠 → 打盹 → 熟睡

睡眠序列：60 秒无操作 → 打哈欠 → 打盹 → 趴下熟睡。鼠标一动立刻惊醒弹起。

• 完整的事件到状态映射、迷你模式和点击反应：https://github.com/rullerzhou-afk/clawd-on-desk/blob/main/docs/guides/state-mapping.md

👀 交互特性

• 眼球追踪：空闲状态下，Clawd 的眼睛会跟随鼠标光标移动，身体略微倾斜，影子拉伸增加立体感。
• 点击彩蛋：双击 Clawd 戳一下；连点 4 次触发 “抓狂” 动画。
• 任意拖拽：可随时拖动 Clawd 到屏幕任意位置，采用 Pointer Capture 机制防止快速甩脱。
• 位置记忆：关闭后记住最后位置（包括迷你模式状态），下次启动恢复。
• 点击穿透：Clawd 的透明背景区域可穿透点击到下方窗口，不干扰正常工作。

📐 迷你模式

将 Clawd 拖动到屏幕右边缘，它会自动缩小为迷你形态藏在边缘。鼠标悬停时，Clawd 探出头来查看；鼠标移开又缩回去。既不占屏幕空间，又能随时查看 Agent 状态。

🔔 权限气泡（亮点）

这是 Clawd on Desk 最具实用价值的功能。当 Claude Code 等工具发起权限请求（如执行命令、读写文件、网络请求）时：

1. 桌面弹出气泡卡片，显示请求内容和选项
2. 一键审批：Allow（允许）/ Deny（拒绝）/ Always（始终允许）
3. 全局快捷键：Ctrl+Shift+Y允许，Ctrl+Shift+N拒绝——不抬手即可操作
4. 多请求堆叠：多个权限请求从屏幕右下角向上依次排列
5. 自动消失：如果在终端中先回答了权限，桌面气泡自动关闭

这意味着你不需要频繁切换到 Claude Code 终端窗口就能处理权限请求，大幅提升编码流畅度。

📊 会话管理

• 多会话追踪：同时监控多个 Agent 会话，显示最高优先级的状态
• 会话仪表盘 + HUD：悬浮信息面板展示当前运行中的 Agent 及其状态
• 一键跳转：点击 HUD 可直接切换到对应终端窗口
• 进程存活检测：Agent 进程退出后自动清理，不会残留"僵尸会话"
• 启动恢复：Clawd 重启时，如果检测到 Agent 仍在运行，自动恢复为活跃状态

🌐 Remote SSH 远程支持

在远程服务器上使用 Claude Code 时，Clawd 也能可视化远程 Agent 状态：

1. 通过一键脚本将 Clawd 部署到远程服务器
2. 利用SSH 反向端口转发将远程 Agent 的状态数据回传到本地
3. 权限审批气泡同样可以穿越 SSH 隧道，在本地桌面弹出

这使得远程开发体验和本地开发几乎一致。

🎨 皮肤与主题

Clawd on Desk 内置三套像素风主题，同时支持自定义主题和社区主题包导入：

支持导入 Codex Pet 动画包，社区可以制作和分享自定义皮肤。

⚙️ 系统功能一览

🚀 快速开始

方式一：预构建安装包（推荐）

从 GitHub Releases 下载对应平台安装包：

安装后直接启动，Clawd 会自动检测并注册已安装的 AI Agent hooks。

Windows 用户也可通过WinGet一键安装：

wingetinstallrullerzhou-afk.clawd-on-desk

Arch Linux 用户可通过AUR安装：

yay-Sclawd-on-desk-bin

方式二：从源码运行

前置要求：Node.js 18+

# 克隆仓库gitclone https://github.com/rullerzhou-afk/clawd-on-desk.gitcdclawd-on-desk# 安装依赖npminstall# 启动（自动注册 Claude Code hooks）npmstart

🔧 Claude Code 配置

Clawd on Desk 对 Claude Code 提供开箱即用的支持。安装后 Clawd 会自动在 Claude Code 配置中注册两个 hook：

1. 命令 Hook：监听 Claude Code 的状态变化（思考、打字、构建、完成、错误等）
2. HTTP 权限 Hook：捕获权限请求并转发到桌面气泡

无需手动编辑配置文件。如果 Clawd 未运行，这些 hook 会自动静默跳过，不影响 Claude Code 正常工作。

🆚 同类项目对比

💡 使用场景

• 日常编码：不用频繁切回终端检查 Claude Code 是否跑完——看一眼 Clawd 就知道。
• 多任务并行：同时跑多个 Agent 时，Clawd 帮你区分谁在干什么。
• 权限审批：弹窗直接在桌面处理，保持编码心流不中断。
• 远程开发：SSH 到服务器干活，本地 Clawd 照样感知状态。
• 团队协作：展示给同事看，“我的 AI 正在干活” 一目了然 😄

🔗 相关链接

• GitHub 仓库：https://github.com/rullerzhou-afk/clawd-on-desk
• Releases 下载：https://github.com/rullerzhou-afk/clawd-on-desk/releases
• Awesome Claude Code：https://github.com/topics/awesome-claude-code