目录
- [Clawd on Desk --- AI 智能体桌面宠物](#Clawd on Desk — AI 智能体桌面宠物)
-
- 项目简介
- 核心功能
-
- [🤖 多 Agent 实时感知（14+ 种工具）](#🤖 多 Agent 实时感知（14+ 种工具）)
- [🎬 12 种动画状态](#🎬 12 种动画状态)
- [👀 交互特性](#👀 交互特性)
- [📐 迷你模式](#📐 迷你模式)
- [🔔 权限审批气泡（亮点）](#🔔 权限审批气泡（亮点）)
- [📊 会话管理](#📊 会话管理)
- [🌐 Remote SSH 远程支持](#🌐 Remote SSH 远程支持)
- [🎨 皮肤与主题](#🎨 皮肤与主题)
- [⚙️ 系统功能一览](#⚙️ 系统功能一览)
- [🚀 快速开始](#🚀 快速开始)
- [🔧 Claude Code 配置](#🔧 Claude Code 配置)
- [🆚 同类项目对比](#🆚 同类项目对比)
- [💡 使用场景](#💡 使用场景)
- [🔗 相关链接](#🔗 相关链接)
Clawd on Desk --- AI 智能体桌面宠物
我养了一只螃蟹，它能帮我看代码------Clawd on Desk 桌宠体验
开源 AI 桌宠 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 日发布）。
| 项目信息 | 详情 |
|---|---|
| 开源协议 | MIT（代码）/ 美术素材保留版权 |
| 技术栈 | Electron + Node.js |
| 支持平台 | Windows 11 / macOS / Linux |
| 多语言 | English、简体中文、繁體中文、한국어、日本語 |
| 安装方式 | 预构建安装包 / 源码运行 / WinGet / AUR |
核心功能
🤖 多 Agent 实时感知（14+ 种工具）
Clawd 通过读取各 AI 编程工具的 hooks / 插件 / 日志 来感知状态变化，无需额外配置即可自动识别已安装的 Agent：
| AI 编程助手 | 接入方式 | 识别方式 |
|---|---|---|
| Claude Code | 命令 hook + HTTP 权限 hook | 自动注册 |
| Codex CLI | 官方 hooks + JSONL 日志回退 | 自动注册 |
| Copilot CLI | 命令 hooks | 手动配置 |
| Gemini CLI | 命令 hooks | 自动注册 |
| Cursor Agent | Cursor IDE hooks | 自动注册 |
| CodeBuddy | Claude Code 兼容 hooks | 自动注册 |
| Qwen Code | 插件 / hooks | 自动注册 |
| Kimi CLI / Kiro CLI | hooks | 自动注册 |
| opencode / Pi / OpenClaw / Hermes | 插件机制 | 自动注册 |
🎬 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 等工具发起权限请求（如执行命令、读写文件、网络请求）时：
- 桌面弹出毛玻璃卡片，显示请求内容和选项
- 一键审批：Allow（允许）/ Deny（拒绝）/ Always（始终允许）
- 全局快捷键 ：
Ctrl+Shift+Y允许，Ctrl+Shift+N拒绝------不抬手即可操作 - 多请求堆叠：多个权限请求从屏幕右下角向上依次排列
- 自动消失：如果在终端中先回答了权限，桌面气泡自动关闭
这意味着你不需要频繁切换到 Claude Code 终端窗口就能处理权限请求，大幅提升编码流畅度。
📊 会话管理
- 多会话追踪：同时监控多个 Agent 会话，显示最高优先级的状态
- 会话仪表盘 + HUD：悬浮信息面板展示当前运行中的 Agent 及其状态
- 一键跳转：点击 HUD 可直接切换到对应终端窗口
- 进程存活检测：Agent 进程退出后自动清理，不会残留"僵尸会话"
- 启动恢复：Clawd 重启时，如果检测到 Agent 仍在运行，自动恢复为活跃状态
🌐 Remote SSH 远程支持
在远程服务器上使用 Claude Code 时，Clawd 也能可视化远程 Agent 状态：
- 通过一键脚本将 Clawd 部署到远程服务器
- 利用 SSH 反向端口转发 将远程 Agent 的状态数据回传到本地
- 权限审批气泡同样可以穿越 SSH 隧道，在本地桌面弹出
这使得远程开发体验和本地开发几乎一致。
🎨 皮肤与主题
Clawd on Desk 内置三套像素风主题，同时支持自定义主题和社区主题包导入：
| 主题 | 形象 | 说明 |
|---|---|---|
| 🦀 Clawd | 像素螃蟹 | 默认主题，经典红色小螃蟹 |
| 🐱 Calico | 三花猫 | 日式三花猫风格 |
| ☁️ Cloudling | 云宝 | 软萌云朵造型 |
支持导入 Codex Pet 动画包，社区可以制作和分享自定义皮肤。
⚙️ 系统功能一览
| 功能 | 说明 |
|---|---|
| 单实例锁 | 防止重复启动多个 Clawd 窗口 |
| 自启动 | Claude Code SessionStart hook 可自动拉起 Clawd |
| 免打扰模式 | 右键菜单或托盘进入 DND，所有事件静默 |
| 音效 | 任务完成 / 权限请求时播放短音效（可关闭，10 秒冷却） |
| 系统托盘 | 调整大小（S/M/L）、免打扰、切换语言、自启动、检查更新 |
| 自动更新 | 检查 GitHub Releases；Windows NSIS 更新，macOS/Linux git pull + 重启 |
| i18n 多语言 | English / 简体中文 / 繁體中文 / 한국어 / 日本語 |
🚀 快速开始
方式一：预构建安装包（推荐）
从 GitHub Releases 下载对应平台安装包：
| 平台 | 安装包 |
|---|---|
| Windows 11 | Clawd-on-Desk-Setup-<version>-x64.exe 或 arm64.exe |
| macOS | Clawd-on-Desk-<version>.dmg |
| Linux | Clawd-on-Desk-<version>.AppImage 或 .deb |
安装后直接启动，Clawd 会自动检测并注册已安装的 AI Agent hooks。
Windows 用户也可通过 WinGet 一键安装：
bash
winget install rullerzhou-afk.clawd-on-deskArch Linux 用户可通过 AUR 安装：
bash
yay -S clawd-on-desk-bin方式二：从源码运行
前置要求：Node.js 18+
bash
# 克隆仓库
git clone https://github.com/rullerzhou-afk/clawd-on-desk.git
cd clawd-on-desk
# 安装依赖
npm install
# 启动（自动注册 Claude Code hooks）
npm start🔧 Claude Code 配置
Clawd on Desk 对 Claude Code 提供开箱即用的支持。安装后 Clawd 会自动在 Claude Code 配置中注册两个 hook：
- 命令 Hook：监听 Claude Code 的状态变化（思考、打字、构建、完成、错误等）
- HTTP 权限 Hook：捕获权限请求并转发到桌面气泡
无需手动编辑配置文件。如果 Clawd 未运行，这些 hook 会自动静默跳过，不影响 Claude Code 正常工作。
🆚 同类项目对比
| 项目 | 定位 | 特点 |
|---|---|---|
| Clawd on Desk | AI Agent 状态可视化 | 14+ Agent 支持，权限气泡是杀手功能，多会话管理 |
| ClaudePet | Claude Code 会话数据展示 | 侧重 token 用量、git 状态、上下文窗口监控 |
| OpenPets | 通用桌宠框架 | MCP 集成，可扩展插件系统，侧重陪伴感 |
| claude-pet | 虚拟养成宠物 | 喂养 / 玩耍机制，Baby→Teen→Adult 成长阶段 |
💡 使用场景
- 日常编码：不用频繁切回终端检查 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