Clawd on Desk

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

_{🌏 Don't see your language? Open a PR to add one — Español, Français, Deutsch, etc. all welcome.}

Clawd 生活在你的桌面上，实时响应你的 AI 编码代理的操作。当你开始一个长任务后离开，当这只螃蟹告诉你任务完成时再回来即可。 当输入提示时会思考，工具运行时会打字，处理子代理时会摆动或杂耍，审查权限，任务完成时庆祝，你离开时会进入睡眠。内置三个主题：**Clawd**（像素螃蟹）、**Calico**（三花猫）和 **Cloudling**（云宝），并全面支持自定义主题和导入 Codex Pet 动画包。 ## 功能 ### 多代理支持 - **Claude Code** — 通过命令钩子 + HTTP 权限钩子实现完整集成 - **Codex CLI** — 官方钩子，带 JSONL 后备方案（`~/.codex/sessions/`），自动注册并包含真实的权限气泡 - **Copilot CLI** — 通过 `~/.copilot/hooks/hooks.json` 的命令钩子 - **Gemini CLI** — 通过 `~/.gemini/settings.json` 的命令钩子（Clawd 启动时自动注册，或运行 `npm run install:gemini-hooks`） - **Cursor Agent** — [Cursor IDE 钩子](https://cursor.com/docs/agent/hooks)位于 `~/.cursor/hooks.json`（Clawd 启动时自动注册，或运行 `npm run install:cursor-hooks`） - **CodeBuddy** — 兼容 Claude Code 的命令钩子 + HTTP 权限钩子，通过 `~/.codebuddy/settings.json` 配置（Clawd 启动时自动注册，或运行 `node hooks/codebuddy-install.js`） - **Kiro CLI** — 命令钩子注入到 `~/.kiro/agents/` 下的自定义代理配置中，另外还有一个自动创建的 `clawd` 代理，该代理会在 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`） - **opencode** — [插件集成](https://opencode.ai/docs/plugins)通过 `~/.config/opencode/opencode.json` 配置（Clawd 启动时自动注册）；零延迟事件流、带 Allow/Always/Deny 选项的权限气泡，以及当通过 `task` 工具生成并行子代理时的构建动画 - **Pi** — 全局扩展通过 `~/.pi/agent/extensions/clawd-on-desk`（Clawd 启动时自动注册，或运行 `npm run install:pi-extension`）；交互式生命周期更新加上对 `bash` / `write` / `edit` 工具调用的权限气泡，Pi 终端确认作为后备方案 - **OpenClaw** — 仅状态插件集成通过 `~/.openclaw/openclaw.json`（当 OpenClaw 配置已存在时自动注册，或运行 `npm run install:openclaw-plugin`）；本地 `openclaw tui --local` 会话驱动 Clawd 动画，第 1 阶段不包含权限气泡或终端焦点 - **Hermes Agent** — [插件集成](https://hermes-agent.org/)通过 Hermes 的托管插件目录（Hermes 安装时自动注册，或运行 `npm run install:hermes-plugin`）；支持状态、会话、SessionEnd 和终端焦点 - **多代理共存** — 同时运行所有代理；Clawd 独立跟踪每个会话 ### 动画与交互 - **实时状态感知** — 代理钩子和日志轮询自动驱动 Clawd 的动画 - **12 种动画状态** — 空闲、思考、打字、构建、子代理摆动、多子代理杂耍、错误、开心、通知、打扫、搬运、睡眠 - **Codex Pet 导入** — 从 `Settings…` → `Theme` 导入 Codex Pet zip 包；Clawd 会将其图集动画适配为托管主题 - **眼球追踪** — 空闲状态下，Clawd 会追踪你的光标，并伴有身体倾斜和影子拉伸 - **睡眠序列** — 空闲 60 秒后打哈欠、打瞌睡、瘫倒、入睡；鼠标移动会触发惊醒动画 - **点击反应** — 双击戳一下，点击四次会慌乱挣扎 - **从任意状态拖拽** — 随时抓取 Clawd（指针捕获防止快速甩动丢失），松开后恢复状态 - **迷你模式** — 拖到屏幕右边缘或右键选择“迷你模式”；Clawd 隐藏在屏幕边缘，悬停时可窥视，有迷你提醒/庆祝动画，以及抛物线跳跃过渡动画 ### 权限气泡 - **应用内权限审查** — 当 Claude Code、Codex CLI、CodeBuddy、opencode 或 Pi 请求工具权限时，Clawd 会弹出浮动气泡卡片，而不是在终端中等待 - **允许 / 拒绝 / 代理原生额外操作** — 一键批准或拒绝，加上当源代理支持时的权限规则 / `Always` 操作 - **全局热键** — `Ctrl+Shift+Y` 允许，`Ctrl+Shift+N` 拒绝最新的权限气泡（仅在气泡可见时注册） - **堆叠布局** — 多个权限请求从右下角向上堆叠 - **自动关闭** — 如果你先在终端中回答，气泡会自动消失 - **按代理切换** — 打开 `Settings…` → `Agents`，选择一个代理，然后关闭 `Show pop-up bubbles` 以将提示保留在该代理自己的终端/TUI 中 ### 会话智能 - **多会话跟踪** — 跨所有代理的会话解析为最高优先级状态 - **子代理感知** — 1 个子代理时戴耳机摆动，2 个以上则杂耍三个球 - **会话面板 + HUD** — 右键或托盘 → `Open Dashboard` 检查活跃会话、近期事件、别名，并跳转到终端；Clawd 附近的紧凑 HUD 保持当前活跃会话可见 - **终端焦点** — 面板/HUD 操作跳转到特定会话的终端窗口；通知/关注状态自动聚焦到相关终端 - **进程存活性检测** — 检测已崩溃/退出的受支持代理进程，并清理孤立会话 - **启动恢复** — 如果 Clawd 在任何受支持的代理仍在运行时重启，它会保持清醒而不是进入睡眠 ### 系统 - **点击穿透** — 透明区域将点击传递到底层窗口；只有 Clawd 的身体是可交互的 - **位置记忆** — Clawd 记住你上次放置它的位置（包括迷你模式） - **单实例锁** — 防止重复的 Clawd 窗口 - **自动启动** — Claude Code 的 SessionStart 钩子可以在 Clawd 未运行时自动启动它 - **免打扰** — 右键或托盘菜单进入睡眠模式；所有钩子事件都会静音，直到你唤醒 Clawd。免打扰期间抑制权限气泡 — Codex 和 opencode 回退到其原生提示，Pi 回退到终端确认，而 Claude Code 和 CodeBuddy 回退到其内置权限流程 - **音效** — 任务完成和权限请求时的简短音频提示（通过右键菜单切换；10 秒冷却时间，免打扰期间自动静音） - **系统托盘** — 调整大小 (S/M/L)、免打扰模式、语言切换、自动启动、检查更新 - **国际化 (i18n)** — 英文、简体中文、繁体中文、韩文和日文 UI；通过右键菜单或托盘切换 - **自动更新** — 检查 GitHub 发布；Windows 在退出时安装 NSIS 更新，macOS/Linux 如果从克隆的仓库运行则执行 `git pull` + 重启 ## 动画

Idle	Thought Bubble	Typing	Building	1 Subagent	2+ Subagents
Calico Idle	Calico Thinking	Calico Typing	Calico Building	Calico Juggling	Calico Conducting
Cloudling Idle	Cloudling Thinking	Cloudling Typing	Cloudling Building	Cloudling Juggling	Cloudling Conducting

完整的事件到状态映射、迷你模式和点击反应：**[docs/guides/state-mapping.md](docs/guides/state-mapping.md)** ## 多显示器 Clawd 适应多显示器设置：比例缩放使用 Clawd 启动时所在的显示器，纵向显示器会获得有界的放大以使宠物在高窄屏幕上保持可读性，并且你可以将 Clawd 拖拽到不同显示器上。

_{想查看实际的多显示器行为？观看本仓库中的演示视频。}

## 快速开始 正常使用，请从 **[GitHub Releases](https://github.com/rullerzhou-afk/clawd-on-desk/releases/latest)** 下载最新的预构建安装程序： - **Windows**: `Clawd-on-Desk-Setup--x64.exe` 或 `Clawd-on-Desk-Setup--arm64.exe` - **macOS**: `.dmg` - **Linux**: `.AppImage` 或 `.deb` 安装后启动 Clawd；支持的代理钩子/插件会在启动时自动同步。 仅在贡献代码、测试未发布代码或调试集成时才从源代码运行。源代码安装会下载 Electron/构建工具，并可能创建大型的 `node_modules` 目录。 ``` # 克隆仓库 git clone https://github.com/rullerzhou-afk/clawd-on-desk.git cd clawd-on-desk # 安装依赖项 npm install # 启动 Clawd（启动时自动注册 Claude Code 钩子） npm start ``` **Claude Code** 和 **Codex CLI** 开箱即用，自动注册钩子。**Gemini CLI**、**Cursor Agent**、**CodeBuddy**、**Kiro CLI**、**Kimi Code CLI (Kimi-CLI)**、**opencode**、**Pi**、**OpenClaw** 和 **Hermes Agent** 在 Clawd 启动时自动注册（如果已安装；OpenClaw 还需要一个已初始化的配置）。**Copilot CLI** 仍然需要一次性钩子设置。还涵盖了远程 SSH、WSL 和特定平台注意事项（macOS / Linux）：**[docs/guides/setup-guide.md](docs/guides/setup-guide.md)** 关于官方 `Codex + WSL` 状态、Clawd 当前的实现边界以及为何这容易被误解，请参阅：**[docs/guides/codex-wsl-clarification.md](docs/guides/codex-wsl-clarification.md)** ## 已知限制 某些代理存在功能缺失（无权限气泡、轮询延迟、无终端焦点）。查看完整表格：**[docs/guides/known-limitations.md](docs/guides/known-limitations.md)** ## 自定义主题 Clawd 支持自定义主题 — 用你自己的角色和动画替换默认的螃蟹。如果你已经有 Codex Pet 包，可以从 `Settings…` → `Theme` → `Import pet zip` 导入其 zip 文件；Clawd 会自动将图集转换为托管主题。 **快速开始：** 1. 搭建主题骨架： node scripts/create-theme.js my-theme # 或 npm run create-theme -- my-theme 不带参数也可以：它会在你的用户主题目录中创建下一个可用的 `my-theme` 骨架。 2. 编辑 `theme.json` 并创建你的资源（SVG、GIF、APNG、WebP、PNG、JPG 或 JPEG） 3. 重启 Clawd 或打开 `Settings…` → `Theme` → 选择你的主题 **最小可行主题：** 1 个 SVG（带眼球追踪的空闲状态） + 7 个 GIF/APNG 文件（思考、工作、错误、开心、通知、睡眠、醒来）。眼球追踪可以禁用，以便所有状态使用任何格式。 分发前验证你的主题： ``` node scripts/validate-theme.js path/to/your-theme ``` `Settings…` → `Theme` 中的主题卡片现在会显示功能徽章，如 `Tracked idle`、`Static theme`、`Mini`、`Direct sleep` 和 `No reactions`，以便用户在切换前了解主题支持什么功能。 参阅 [docs/guides/guide-theme-creation.md](docs/guides/guide-theme-creation.md) 获取完整的创建指南，包含分级路径（新手 → 高级）、`theme.json` 字段参考和资源指南。 ### 路线图 我们未来想探索的一些事情： - 通过从 `codex.exe` PID 查询进程树来实现 Codex 终端焦点 - 自动注册 Copilot CLI 钩子（就像我们为 Claude Code 所做的那样） - 主题注册表和应用内下载 - 用于干净卸载应用的钩子卸载脚本 ## 贡献 Clawd on Desk 是一个社区驱动的项目。欢迎提交错误报告、功能想法和拉取请求 — 打开一个 [issue](https://github.com/rullerzhou-afk/clawd-on-desk/issues) 进行讨论或直接提交 PR。 ### 维护者

@rullerzhou-afk 鹿鹿 · creator

@YOIMIYA66 maintainer

### 贡献者 感谢所有帮助 Clawd 变得更好的人：

显示所有 48 位贡献者

PixelCookie-zyf	yujiachen-y	AooooooZzzz	purefkh	Tobeabellwether	Jasonhonghh	crashchen
hongbigtou	InTimmyDate	NeizhiTouhu	xu3stones-cmd	androidZzT	Ye-0413	WanfengzzZ
TaoXieSZ	ssly	stickycandy	Rladmsrl	YOIMIYA66	Kevin7Qi	sefuzhou770801-hub
Tonic-Jin	seoki180	sophie-haynes	PeterShanxin	CHIANGANGSTER	JaeHyeon-KAIST	hhhzxyhhh
TVpoet	zeus6768	anhtrinh919	tomaioo	v-avuso	livlign	tongguang2
Ziy1-Tan	tatsuyanakanogaroinc	yeonhub	joshua-wu	nmsn	sunnysonx	YuChenYunn
jhseo-b	Hwasowl	XiangZheng2002	keiyo118	pan93412	taehwanis

## 致谢 - Clawd 像素艺术参考来自 [clawd-tank](https://github.com/marciogranzotto/clawd-tank)，作者 [@marciogranzotto](https://github.com/marciogranzotto) - 分享于 [LINUX DO](https://linux.do/) 社区 ## 许可证 源代码遵循 [GNU Affero General Public License v3.0](LICENSE) (AGPL-3.0) 许可。 **艺术品和捆绑的主题资源（包括 `assets/` 和 `themes/*/assets/`）不受 AGPL-3.0 覆盖。** 其所有权利归各自版权所有者保留。详情请见 [assets/LICENSE](assets/LICENSE) 和下方通知。 - **Clawd** 角色是 [Anthropic](https://www.anthropic.com) 的财产。这是一个非官方的粉丝项目，与 Anthropic 无关或未经其认可。 - **三花猫 (Calico cat)** 艺术作品由 鹿鹿 ([@rullerzhou-afk](https://github.com/rullerzhou-afk)) 创作。保留所有权利。 - **云宝 (Cloudling)** 艺术作品由 鹿鹿 ([@rullerzhou-afk](https://github.com/rullerzhou-afk)) 创作。保留所有权利。Cloudling 的视觉方向包含对 OpenAI Codex 徽标的致敬；Codex/OpenAI 标志仍是 OpenAI 的财产，本项目与 OpenAI 无关或未经其认可。 - **第三方贡献**：版权由相应艺术家保留。 **没有加密货币。** 本项目没有代币、硬币、NFT 或空投，并且与任何加密货币项目无关。

标签：AI编码代理, Claude Code, Codex, Copilot, Cursor, DNS解析, Gemini, Homebrew安装, MITM代理, SOC Prime, 代码辅助, 像素艺术, 动画, 复古风格, 娱乐软件, 开发工具, 开源项目, 数据可视化, 桌面宠物, 状态指示, 用户界面, 网络调试, 自动化, 自定义脚本