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.

claude-codecodexcopilotcursordesktop-petelectrongeminipixel-artsvg-animation

GAI 中文摘要

Clawd on Desk 是一款运行在桌面上的像素风格电子宠物，旨在通过实时视觉交互来监控 Claude Code、Cursor、Copilot 等 AI 编程助手的工作状态。它能够直观展示 AI 的任务进度，让你无需时刻盯着屏幕即可掌握编码进程。

实时同步 AI 状态，通过睡觉、思考、打字、杂耍等多种动画动作表现 AI 当前的运行阶段。内置 Clawd 螃蟹、Calico 三花猫及 Cloudling 云宝三种主题，并支持用户自定义导入动画包。提供完善的多代理适配能力，深度集成 Claude Code、Codex、Copilot、Gemini 及多种主流 CLI 编码工具。支持跨平台运行，完美兼容 Windows、macOS 和 Linux 系统，满足不同开发者的使用需求。

适用于经常使用 AI 辅助编程且希望提升开发乐趣的程序员。该项目特别适合在运行耗时较长的自动化任务时使用，让你能够一边休息或处理其他事务，一边通过桌面宠物了解 AI 的实时工作进度。

⭐

3.6k

Stars

🔱

353

Forks

👁

Watchers

📋

Issues

JavaScriptAGPL-3.0创建于 2026/3/18更新于今天

在 GitHub 上查看

README

由 Gemini 翻译整理

Clawd on Desk

[中文版] · [繁體中文] · [한국어] · [日本語]

🌏 没有看到你的语言？欢迎提交 PR 进行添加 — 支持 Español, Français, Deutsch 等。

Clawd 是一个生活在你桌面上的像素宠物，它能实时响应你的 AI 编程助手正在进行的操作。当你启动一个耗时较长的任务后可以暂时离开，等螃蟹提醒你任务完成时再回来。

当你在输入指令时它会思考，当工具运行时它会敲击键盘，处理子代理时它会跳舞或杂耍，它还会协助审查权限、在任务完成时为你庆祝，并在你离开时进入睡眠。内置三种主题：Clawd（像素螃蟹）、Calico（三花猫）和 Cloudling（云宝），并全面支持自定义主题和导入 Codex Pet 动画包。

支持 Windows 11、macOS 和 Ubuntu/Linux。Windows 版本提供独立的 x64 和 ARM64 安装程序。从源码构建需要 Node.js。兼容 Claude Code, Codex CLI, Copilot CLI, Gemini CLI, Antigravity CLI (agy), Cursor Agent, CodeBuddy, Kiro CLI, Kimi Code CLI (Kimi-CLI), Qwen Code, opencode, Pi, OpenClaw 以及 Hermes Agent。

功能特性

多 Agent 支持

Claude Code — 通过命令钩子 (command hooks) + HTTP 权限钩子实现完全集成
Codex CLI — 带有 JSONL 后备 (~/.codex/sessions/) 的官方钩子，自动注册并支持实时权限气泡
Copilot CLI — 通过 ~/.copilot/hooks/hooks.json 使用命令钩子
Gemini CLI — 通过 ~/.gemini/settings.json 使用命令钩子（Clawd 启动时自动注册，或运行 npm run install:gemini-hooks）
Antigravity CLI (agy) — 通过 ~/.gemini/config/hooks.json 使用命令钩子（在 Antigravity 配置存在时自动注册，或运行 npm run install:antigravity-hooks）；仅状态同步：Clawd 不会为 agy 弹出权限气泡，所有的“允许/拒绝/总是允许”选择均在 agy 自身的终端菜单中进行
Cursor Agent — 通过 ~/.cursor/hooks.json 使用 Cursor IDE 钩子（Clawd 启动时自动注册，或运行 npm run install:cursor-hooks）
CodeBuddy — 兼容 Claude Code 的命令钩子 + 通过 ~/.codebuddy/settings.json 的 HTTP 权限钩子（Clawd 启动时自动注册，或运行 node hooks/codebuddy-install.js）
Kiro CLI — 命令钩子注入到 ~/.kiro/agents/ 下的自定义 Agent 配置中，此外还会自动创建一个 clawd Agent，并在 Clawd 启动时从 Kiro 内置的 kiro_default 重新同步，因此你可以通过 kiro-cli --agent clawd 或 /agent swap clawd 以最小的行为偏差启用钩子（Clawd 启动时自动注册，或运行 npm run install:kiro-hooks）。状态钩子已在 macOS 和 Windows 上验证。
Kimi Code CLI (Kimi-CLI) — 通过 ~/.kimi/config.toml ([[hooks]] 条目) 使用命令钩子（Clawd 启动时自动注册，或运行 npm run install:kimi-hooks）
Qwen Code — 通过 ~/.qwen/settings.json 使用命令钩子（Clawd 启动时自动注册，或运行 npm run install:qwen-hooks）；支持状态追踪和 Qwen PermissionRequest 桌面确认气泡
opencode — 通过 ~/.config/opencode/opencode.json 使用插件集成（Clawd 启动时自动注册）；支持零延迟事件流、包含允许/总是/拒绝选项的权限气泡，以及当通过 task 工具生成并行子 Agent 时的构建动画
Pi — 通过 ~/.pi/agent/extensions/clawd-on-desk 实现全局扩展（Clawd 启动时自动注册，或运行 npm run install:pi-extension）；在保留 Pi 默认 YOLO 行为的同时，提供仅状态的交互式生命周期和工具活动更新
OpenClaw — 通过 ~/.openclaw/openclaw.json 实现仅状态的插件集成（在 OpenClaw 配置存在时自动注册，或运行 npm run install:openclaw-plugin）；本地 openclaw tui --local 会话驱动 Clawd 动画，第一阶段暂不支持权限气泡或终端焦点
Hermes Agent — 通过 Hermes 管理的插件目录实现插件集成（Hermes 安装时自动注册，或运行 npm run install:hermes-plugin）；支持状态、会话、SessionEnd 和终端焦点
多 Agent 共存 — 同时运行所有 Agent；Clawd 会独立追踪每个会话

动画与交互

实时状态感知 — 通过 Agent 钩子和日志轮询自动驱动 Clawd 的动画
12 种动画状态 — 空闲、思考、打字、构建、子 Agent 跳舞、多个子 Agent 杂耍、错误、开心、通知、清扫、搬运、睡觉
Codex Pet 导入 — 通过 Settings… → Theme 导入 Codex Pet zip 包；Clawd 会将其图集动画适配为可管理的内置主题
眼球追踪 — 在空闲状态下，Clawd 会跟随你的鼠标光标，并伴随身体倾斜和阴影拉伸
睡眠序列 — 空闲 60 秒后会打哈欠、打瞌睡、倒下并进入睡眠；鼠标移动会触发惊醒动画