Clawd on Desk 完整指南让 AI 编码 Agent 化身像素桌面宠物实时看清它的工作状态【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-deskClawd on DeskClawd 桌宠是一款免费的像素桌面宠物工具它实时盯住 Claude Code、Codex、Cursor、Copilot、Gemini 等 20 款 AI 编码 AgentAgent 在思考时它冒思考泡泡跑工具时它敲键盘任务完成时它庆祝你离开时它睡觉。发起长任务后不用死守终端——等桌宠告诉你干完了再回来即可。本指南带你从零上手这个 AI 编码状态监控桌宠。一、Clawd on Desk 是什么解决什么问题AI 编码 Agent 跑长任务时终端输出又长又碎人很难一眼看清它是在思考、在改文件、在跑测试还是卡在了权限确认上Clawd 桌宠把这一切变成动画语言一只住在桌面上的像素螃蟹也可换成三花猫、云宝用 12 种动画实时映射 Agent 状态——透明窗口、点击穿透不占任务栏、不打断你的工作流。二、快速安装三种方式让桌宠住上你的桌面支持Windows 11 / macOS / Ubuntu、LinuxWindows 提供 x64 与 ARM64 双架构安装包。1. 推荐下载预构建安装包普通用户WindowsClawd-on-Desk-Setup-version-x64.exe或 arm64macOS.dmgLinux.AppImage或.deb安装后直接启动即可。全新安装默认自动同步 Claude Code 和 Codex的 hooks开箱即用其他 Agent 在 设置 → Agents 里点一下安装即可。2. 源码运行贡献者 / 调试集成源码运行需要 Node.js ≥ 22.12应用主入口为 src/main.jsgit clone https://gitcode.com/gh_mirrors/cl/clawd-on-desk cd clawd-on-desk npm install npm start # 启动时自动注册 Claude Code 与 Codex hooks3. 开机自启Claude Code 的 SessionStart hook 可在 Clawd 未运行时自动拉起它也可在系统托盘里开启自启动。更多平台细节WSL、远程 SSH、macOS/Linux 注意事项见官方配置指南。三、12 种实时动画Agent 工作状态一眼看懂这是 Clawd 桌宠最核心的能力Agent 的生命周期事件被自动映射成动画你甚至不用看终端就能读出进度。你看到螃蟹在…Agent 正在…打转眼球看你待机会话空闲等待指令冒思考泡泡你提交了 Prompt模型思考中敲键盘打字正在调用工具改文件、跑命令戴耳机律动 / 三球杂耍1 个 / 2 个以上子代理并行工作疯狂敲打建造多会话同时构建报错姿势工具执行失败敲小锣注意任务结束 / 上下文压缩完成需要你查看举牌报警通知等待权限确认扫地 / 搬箱子上下文压缩 / 创建 worktree打哈欠 → 倒下睡觉60 秒无活动自动进入睡眠几个有趣的小细节待机时它的眼球会跟随你的鼠标移动你走开 60 秒它会打哈欠、打盹、缓缓躺下入睡一移动鼠标又会被惊得弹起来双击戳它、连点 4 下都有隐藏反应彩蛋。完整的事件-状态对照表见状态映射文档动画循环逻辑可参考 src/animation-cycle.js。四、权限气泡不回到终端一键批准 AI 的敏感操作AI 编码 Agent 执行高危操作删文件、跑脚本前常会请求权限传统做法是切回终端敲y。Clawd 桌宠把权限请求弹成桌面浮动气泡卡片右下角堆叠显示一键 允许 / 拒绝支持的 Agent 还会提供Always永久规则选项全局快捷键CtrlShiftY允许、CtrlShiftN拒绝最新气泡自动关闭如果你先在终端里回答了气泡自动消失处理模式三选一每次询问 / 仅提问弹窗 / 自动放行自动放行重启后会安全降级按 Agent 单独开关在 设置 → Agents 里可关闭某个 Agent 的弹窗让提示回到它自己的终端权限服务的核心路由实现在 src/server.js 与 src/permission.js自动化策略详见配置指南-权限处理自动化。五、20 AI 编码 Agent 一键接入Clawd 桌宠的杀手锏之一是多 Agent 共存所有会话独立追踪统一解析到最高优先级的状态动画。目前支持的阵容节选集成方式代表 Agent命令 hooks HTTP 权限 hooksClaude Code、CodeBuddy、Qwen Code、Kimi CLI官方 hooks JSONL 日志兜底Codex CLI配置文件 hooksGemini CLI、Copilot CLI、Cursor Agent、Kiro CLI插件 / 扩展opencode、MiMo Code、Pi、OpenClaw、Hermes自定义 HTTP 上报任意本地可执行程序POST 到/state端点接新 Agent 只需两步启动 Clawd → 打开设置 → Agents→ 点对应 Agent 的Install / 安装Clawd 会在每次启动时自动保持 hooks 同步卸载也只删它自己管理的条目不动你的其他配置。各 Agent 的 hook 安装脚本集中在 hooks/ 目录如 hooks/gemini-install.js、hooks/qwen-code-install.jsAgent 适配逻辑在 agents/ 目录统一注册表见 agents/registry.js。不同 Agent 的能力边界有无权限气泡、终端聚焦、轮询延迟等整理在已知限制文档。六、远程监控与手机镜像人不在电脑前也能看状态远程 SSH 模式Agent 跑在云服务器 / 家里的小主机上Clawd 通过SSH 反向端口转发把远程 hook 事件和权限请求隧道回本地桌面——在 设置 → 远程 SSH 里新建 profileuserhost 可选私钥点部署 / 修复 Hook即可。远程会话的状态动画、权限气泡照常显示在本地螃蟹身上全程无需改 Clawd 代码。完整教程见远程 SSH 指南。手机 PWA 实时镜像开启 设置 → Mobile / PWA 后用手机打开配对链接「Clawd Mobile」网页应用会实时广播各会话状态。设计上只读PWA 无法操作你的电脑令牌自动轮换仅限局域网添加到手机主屏幕即成类原生 App。Telegram / 飞书远程审批、Slack 播报权限请求可镜像到 Telegram 或飞书交互卡片人在手机上一键批准Slack 则负责播报任务完成、错误与权限提醒。通道故障时绝不自动拒绝请求安全地继续等待。七、主题、极简模式与桌面小彩蛋三套内置主题Clawd像素螃蟹、Calico三花猫、Cloudling云宝在 设置 → 主题 一键切换还能导入 Codex Pet zip 动画包自动转成主题自制主题运行npm run create-theme -- my-theme生成脚手架最少 1 个 SVG含眼球追踪的待机 7 个动效文件即可分发前用node scripts/validate-theme.js 路径校验。教程见主题创建指南主题素材在 themes/极简模式把螃蟹拖到屏幕右边缘它藏起来只露半身悬停探头招手任务完成时抛物线跳出来庆祝会话 Dashboard HUD右键 / 托盘 → 打开 Dashboard查看所有活跃会话、最近事件一键跳转对应终端窗口免打扰模式右键进入休眠屏蔽需要处理的弹窗远程完成通知仍会送达任务完成还有短音效提醒界面语言简中、繁中、英、日、韩、西、葡七语随切右键菜单长这样八、项目结构速览路径说明src/main.jsElectron 主进程入口窗口与托盘管理src/server.js本机 127.0.0.1 事件 / 权限服务src/state.js多会话状态机与优先级解析hooks/各 Agent 的 hook 安装与同步脚本agents/Agent 适配层如 agents/claude-code.jsthemes/内置主题clawd / calico / cloudlingpwa/手机伴侣 PWA 源码docs/guides/全部使用指南中文齐备package.json构建与安装脚本各 Agent install 命令一览九、常见问题Q会拖慢我的 AI 编码 Agent 吗hooks 只是轻量事件上报走本机 loopback 端口127.0.0.1:23333-23337几乎零延迟日志轮询类集成Codex JSONL 兜底也是低频只读。Q我改坏了 hooks 配置怎么办Clawd 每 5 分钟做一次只读健康巡检能自动发现并修复被清理的 hook 条目仍失败时 Doctor诊断面板会给出手动 Fix 指引。Q它读取我的代码内容吗状态上报只含事件类型与用量数据权限卡片只显示待批准命令不抓取 prompt 或代码正文。Q支持哪些平台Windows 11、macOS、Ubuntu/LinuxWSL 场景下应用内 Pair 会自动探测网络链路并给出警告。写在最后Clawd on Desk 把AI 编码 Agent 现在在干嘛这件小事做成了一个住在桌面上的像素宠物看它睡觉你就安心走开看它敲键盘就知道活还在跑它敲锣报警时你才需要回头。免费开源AGPL-3.0多语言界面装好后基本零配置——下一篇长任务就让螃蟹替你看场吧。更多细节请查阅中文 README。【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-desk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Clawd on Desk 完整指南：让 AI 编码 Agent 化身像素桌面宠物，实时看清它的工作状态
Clawd on Desk 完整指南让 AI 编码 Agent 化身像素桌面宠物实时看清它的工作状态【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-deskClawd on DeskClawd 桌宠是一款免费的像素桌面宠物工具它实时盯住 Claude Code、Codex、Cursor、Copilot、Gemini 等 20 款 AI 编码 AgentAgent 在思考时它冒思考泡泡跑工具时它敲键盘任务完成时它庆祝你离开时它睡觉。发起长任务后不用死守终端——等桌宠告诉你干完了再回来即可。本指南带你从零上手这个 AI 编码状态监控桌宠。一、Clawd on Desk 是什么解决什么问题AI 编码 Agent 跑长任务时终端输出又长又碎人很难一眼看清它是在思考、在改文件、在跑测试还是卡在了权限确认上Clawd 桌宠把这一切变成动画语言一只住在桌面上的像素螃蟹也可换成三花猫、云宝用 12 种动画实时映射 Agent 状态——透明窗口、点击穿透不占任务栏、不打断你的工作流。二、快速安装三种方式让桌宠住上你的桌面支持Windows 11 / macOS / Ubuntu、LinuxWindows 提供 x64 与 ARM64 双架构安装包。1. 推荐下载预构建安装包普通用户WindowsClawd-on-Desk-Setup-version-x64.exe或 arm64macOS.dmgLinux.AppImage或.deb安装后直接启动即可。全新安装默认自动同步 Claude Code 和 Codex的 hooks开箱即用其他 Agent 在 设置 → Agents 里点一下安装即可。2. 源码运行贡献者 / 调试集成源码运行需要 Node.js ≥ 22.12应用主入口为 src/main.jsgit clone https://gitcode.com/gh_mirrors/cl/clawd-on-desk cd clawd-on-desk npm install npm start # 启动时自动注册 Claude Code 与 Codex hooks3. 开机自启Claude Code 的 SessionStart hook 可在 Clawd 未运行时自动拉起它也可在系统托盘里开启自启动。更多平台细节WSL、远程 SSH、macOS/Linux 注意事项见官方配置指南。三、12 种实时动画Agent 工作状态一眼看懂这是 Clawd 桌宠最核心的能力Agent 的生命周期事件被自动映射成动画你甚至不用看终端就能读出进度。你看到螃蟹在…Agent 正在…打转眼球看你待机会话空闲等待指令冒思考泡泡你提交了 Prompt模型思考中敲键盘打字正在调用工具改文件、跑命令戴耳机律动 / 三球杂耍1 个 / 2 个以上子代理并行工作疯狂敲打建造多会话同时构建报错姿势工具执行失败敲小锣注意任务结束 / 上下文压缩完成需要你查看举牌报警通知等待权限确认扫地 / 搬箱子上下文压缩 / 创建 worktree打哈欠 → 倒下睡觉60 秒无活动自动进入睡眠几个有趣的小细节待机时它的眼球会跟随你的鼠标移动你走开 60 秒它会打哈欠、打盹、缓缓躺下入睡一移动鼠标又会被惊得弹起来双击戳它、连点 4 下都有隐藏反应彩蛋。完整的事件-状态对照表见状态映射文档动画循环逻辑可参考 src/animation-cycle.js。四、权限气泡不回到终端一键批准 AI 的敏感操作AI 编码 Agent 执行高危操作删文件、跑脚本前常会请求权限传统做法是切回终端敲y。Clawd 桌宠把权限请求弹成桌面浮动气泡卡片右下角堆叠显示一键 允许 / 拒绝支持的 Agent 还会提供Always永久规则选项全局快捷键CtrlShiftY允许、CtrlShiftN拒绝最新气泡自动关闭如果你先在终端里回答了气泡自动消失处理模式三选一每次询问 / 仅提问弹窗 / 自动放行自动放行重启后会安全降级按 Agent 单独开关在 设置 → Agents 里可关闭某个 Agent 的弹窗让提示回到它自己的终端权限服务的核心路由实现在 src/server.js 与 src/permission.js自动化策略详见配置指南-权限处理自动化。五、20 AI 编码 Agent 一键接入Clawd 桌宠的杀手锏之一是多 Agent 共存所有会话独立追踪统一解析到最高优先级的状态动画。目前支持的阵容节选集成方式代表 Agent命令 hooks HTTP 权限 hooksClaude Code、CodeBuddy、Qwen Code、Kimi CLI官方 hooks JSONL 日志兜底Codex CLI配置文件 hooksGemini CLI、Copilot CLI、Cursor Agent、Kiro CLI插件 / 扩展opencode、MiMo Code、Pi、OpenClaw、Hermes自定义 HTTP 上报任意本地可执行程序POST 到/state端点接新 Agent 只需两步启动 Clawd → 打开设置 → Agents→ 点对应 Agent 的Install / 安装Clawd 会在每次启动时自动保持 hooks 同步卸载也只删它自己管理的条目不动你的其他配置。各 Agent 的 hook 安装脚本集中在 hooks/ 目录如 hooks/gemini-install.js、hooks/qwen-code-install.jsAgent 适配逻辑在 agents/ 目录统一注册表见 agents/registry.js。不同 Agent 的能力边界有无权限气泡、终端聚焦、轮询延迟等整理在已知限制文档。六、远程监控与手机镜像人不在电脑前也能看状态远程 SSH 模式Agent 跑在云服务器 / 家里的小主机上Clawd 通过SSH 反向端口转发把远程 hook 事件和权限请求隧道回本地桌面——在 设置 → 远程 SSH 里新建 profileuserhost 可选私钥点部署 / 修复 Hook即可。远程会话的状态动画、权限气泡照常显示在本地螃蟹身上全程无需改 Clawd 代码。完整教程见远程 SSH 指南。手机 PWA 实时镜像开启 设置 → Mobile / PWA 后用手机打开配对链接「Clawd Mobile」网页应用会实时广播各会话状态。设计上只读PWA 无法操作你的电脑令牌自动轮换仅限局域网添加到手机主屏幕即成类原生 App。Telegram / 飞书远程审批、Slack 播报权限请求可镜像到 Telegram 或飞书交互卡片人在手机上一键批准Slack 则负责播报任务完成、错误与权限提醒。通道故障时绝不自动拒绝请求安全地继续等待。七、主题、极简模式与桌面小彩蛋三套内置主题Clawd像素螃蟹、Calico三花猫、Cloudling云宝在 设置 → 主题 一键切换还能导入 Codex Pet zip 动画包自动转成主题自制主题运行npm run create-theme -- my-theme生成脚手架最少 1 个 SVG含眼球追踪的待机 7 个动效文件即可分发前用node scripts/validate-theme.js 路径校验。教程见主题创建指南主题素材在 themes/极简模式把螃蟹拖到屏幕右边缘它藏起来只露半身悬停探头招手任务完成时抛物线跳出来庆祝会话 Dashboard HUD右键 / 托盘 → 打开 Dashboard查看所有活跃会话、最近事件一键跳转对应终端窗口免打扰模式右键进入休眠屏蔽需要处理的弹窗远程完成通知仍会送达任务完成还有短音效提醒界面语言简中、繁中、英、日、韩、西、葡七语随切右键菜单长这样八、项目结构速览路径说明src/main.jsElectron 主进程入口窗口与托盘管理src/server.js本机 127.0.0.1 事件 / 权限服务src/state.js多会话状态机与优先级解析hooks/各 Agent 的 hook 安装与同步脚本agents/Agent 适配层如 agents/claude-code.jsthemes/内置主题clawd / calico / cloudlingpwa/手机伴侣 PWA 源码docs/guides/全部使用指南中文齐备package.json构建与安装脚本各 Agent install 命令一览九、常见问题Q会拖慢我的 AI 编码 Agent 吗hooks 只是轻量事件上报走本机 loopback 端口127.0.0.1:23333-23337几乎零延迟日志轮询类集成Codex JSONL 兜底也是低频只读。Q我改坏了 hooks 配置怎么办Clawd 每 5 分钟做一次只读健康巡检能自动发现并修复被清理的 hook 条目仍失败时 Doctor诊断面板会给出手动 Fix 指引。Q它读取我的代码内容吗状态上报只含事件类型与用量数据权限卡片只显示待批准命令不抓取 prompt 或代码正文。Q支持哪些平台Windows 11、macOS、Ubuntu/LinuxWSL 场景下应用内 Pair 会自动探测网络链路并给出警告。写在最后Clawd on Desk 把AI 编码 Agent 现在在干嘛这件小事做成了一个住在桌面上的像素宠物看它睡觉你就安心走开看它敲键盘就知道活还在跑它敲锣报警时你才需要回头。免费开源AGPL-3.0多语言界面装好后基本零配置——下一篇长任务就让螃蟹替你看场吧。更多细节请查阅中文 README。【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-desk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
