clawd-on-desk

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

发起一个长任务，起身去做点别的，等螃蟹告诉你完成了再回来。你提问时它思考，工具运行时它打字，子代理多了它杂耍，需要审批时它弹卡片，你离开时它睡觉。

功能特性

• 实时状态：由 agent hook 和日志驱动的 12 种动画状态，还有眼神跟随、睡眠序列、点击反应，以及贴边探头的迷你模式
• 覆盖主流工具：Claude Code、Codex、Copilot、Gemini、Cursor、opencode、Kiro、Qwen 等 20 多款，多会话并行追踪
• 权限气泡：在浮动卡片上或用全局快捷键 Allow / Deny 工具请求，也可以切到自动放行
• 会话一目了然：桌宠旁的 HUD、所有在线会话的仪表盘（一键跳回终端）、额度环，以及只存在本机的活动回顾
• 离开电脑也能管：通过 Telegram 或飞书 / Lark 远程审批，Slack 通知，或在手机上用只读 PWA 查看会话
• 换成你喜欢的样子：内置 Clawd、Calico、Cloudling，可下载官方主题、导入 Codex Pet，或自己做主题
• 哪里写代码就在哪里：Windows（x64 / ARM64）、macOS、Linux，支持 Remote SSH 和 WSL，界面支持 7 种语言

完整功能说明：docs/guides/features.zh-CN.md

快速开始

从 GitHub Releases 下载最新安装包：

启动 Clawd 后它会立刻开始工作：首次启动自动接入 Claude Code 和 Codex。其他 agent 在 设置 → AI 编程工具 里一键安装。

# 克隆仓库
git 克隆 https://github.com/rullerzhou-afk/clawd-on-desk.git  cd clawd-on-desk

# 安装依赖
npm 安装

# 启动 Clawd（启动时自动注册 Claude Code 和 Codex hooks）
npm start

支持的代理

Claude Code · Codex CLI · Copilot CLI · Gemini CLI · Antigravity CLI (agy) · Cursor Agent · CodeBuddy · WorkBuddy · Grok Build · Kiro CLI · KiroCrew · Kimi Code CLI（Kimi-CLI） · Qwen Code · ZCode · CodeWhale · opencode · MiMo Code · Pi · OMP · OpenClaw · Hermes Agent · Qoder · QoderWork · QwenWork（千问办公） · Reasonix CLI · DeepSeek Harness · TraeCode (Trae CN) · MiniMax Code

Claude Code 和 Codex CLI 首次启动即接入；其他集成在 设置 → AI 编程工具 中安装，之后由 Clawd 保持同步。其他本地工具可以通过 自定义 HTTP agent 接口上报状态。各 agent 的细节见 支持的 Agent，没有权限气泡等差异见 已知限制。

主题

内置 Clawd（像素螃蟹）、Calico（三花猫）和 Cloudling（云宝）。Hash Sage（哈希仙人）和 Whale-chan（鲸鱼娘）是可选官方主题，在 设置 → 主题 下载，那里也可以导入 Codex Pet 压缩包。想自己画？运行 npm run create-theme -- my-theme，然后看 主题创作指南。事件与动画的对应关系：状态映射。

社区工具：Live2Pet（作者 @receyuki）可以把 Live2D 模型转换成 Clawd 主题。

文档

社区

欢迎加入 Discord 社区，交流使用心得、寻求帮助、分享主题和桌面配置，也欢迎讨论新想法。支持中文和英文交流；Bug 请提交到 GitHub Issues，方便跟进。

参与贡献

Clawd on Desk 是一个社区驱动的项目。欢迎提 Bug、提需求、提 PR —— 在 Issues 里聊或直接提交 PR。从源码运行、加翻译、接入新 agent 的做法见 参与贡献指南。

维护者

致谢

• Clawd 像素画参考自 clawd-tank by @marciogranzotto
• 本项目在 LINUX DO 社区推广

许可证

源代码基于 GNU Affero General Public License v3.0（AGPL-3.0）开源。

*美术素材和内置主题素材（包括 assets/ 与 `themes//assets/`）不适用 AGPL-3.0 许可。** 所有权利归各自版权持有人所有，详见 assets/LICENSE 及下列说明。

• Clawd 角色设计归属 Anthropic。本项目为非官方粉丝作品，与 Anthropic 无官方关联。
• 三花猫 素材由 鹿鹿 (@rullerzhou-afk) 创作，保留所有权利。
• Cloudling（云宝） 素材由 鹿鹿 (@rullerzhou-afk) 创作，保留所有权利。云宝的视觉方向包含对 OpenAI Codex logo 的致敬；Codex / OpenAI 相关标识仍归 OpenAI 所有，本项目与 OpenAI 无官方关联，也未获 OpenAI 背书。
• Hash Sage（哈希仙人） 以可选官方主题的形式由 rullerzhou-afk/clawd-themes 独立分发，素材版权归 鹿鹿 (@rullerzhou-afk) 所有；许可证与完整署名见主题包内文件。它不适用本项目 AGPL-3.0 源码许可。
• Whale-chan（鲸鱼娘） 以可选官方主题的形式由 rullerzhou-afk/clawd-themes 独立分发。原始角色形象、设定与上游素材的权利归各自原作者所有，本主题署名上游项目 Neko3000/deepseek-whalechan 所列的 ZipZipPipe 与上善无形；鹿鹿 (@rullerzhou-afk) 新作的动画与特效采用 CC BY-NC-SA 4.0，完整条款见主题包内文件。本主题是非官方、非商业同人作品，与 DeepSeek 无关联，也未获其授权或背书；它不适用本项目 AGPL-3.0 源码许可。
• 第三方画师作品：版权归各自作者所有。