Clawd on Desk
一只挂在桌面上的像素螃蟹,实时盯着 Claude Code、Codex、Cursor 等 AI 编程代理的状态——你不用一直盯屏幕,它干完了会告诉你。
- Star 数
- ★ 6.8k
- 最近更新
- 1 天前
- License
- AGPL-3.0
- 主语言
- JavaScript
- FA 评分
- 68/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 跑长任务的 Claude Code 用户:启动重构或批量测试后离开电脑,等螃蟹睡觉或庆祝动画提醒回来,不必反复切回终端查看进度。
- 不适合
- 需要完全离线或禁止本地代理状态外发的团队
- 只想要纯命令行、无 GUI 桌面的用户
- 需要 Trae 国际版或 Linux 版千问办公支持的用户
- 官网
- clawdondesk.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-16最新版本 v1.6.0(2026-11-08)近 7 天每天 +8.6 ★
- 源码审查
- 68/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Clawd on Desk 是一个开源(AGPL-3.0)的 Electron 桌面宠物应用,支持 Windows、macOS 和 Linux。它通过命令钩子、HTTP 钩子、日志轮询或插件集成,读取本地 AI 编程代理(Claude Code、Codex CLI、Copilot CLI、Gemini CLI、Cursor Agent 等二十余种)的会话状态,并驱动像素角色播放 12 种动画状态:思考、打字、子代理杂耍、报错、庆祝、睡觉等。当代理发起权限请求时,Clawd 可弹出悬浮气泡卡让你一键 Allow/Deny,也可通过 Telegram、飞书或 Slack 远程接收通知和审批。应用内置多会话仪表盘、会话 HUD、本地 Recap 统计、订阅配额显示、移动端 PWA 只读镜像,以及三套内置主题(Clawd 螃蟹、Calico 三花猫、Cloudling 云宝)和自定义主题/Codex Pet 动画包导入。安装提供 Windows x64/ARM64 安装包、macOS DMG、Linux AppImage/deb 和 Homebrew cask;Claude Code 与 Codex 的钩子在首次启动时自动注册,其余代理集成需在 Settings → Agents 中手动启用。
Clawd 运行为一个 Electron 桌面进程。对 Claude Code,它通过命令钩子加 HTTP 权限钩子做全量集成;对 Codex CLI 使用官方钩子并以 ~/.codex/sessions/ 的 JSONL 日志作为回退;对 Gemini、Qwen、Cursor、CodeBuddy、Kimi 等,通过写入各自配置文件(如 ~/.gemini/settings.json、~/.cursor/hooks.json、~/.qwen/settings.json)注册命令钩子,也可用 npm run install:gemini-hooks 等脚本安装。它把代理的生命周期事件映射为 12 种动画状态(idle、thinking、typing、building、subagent groove、juggling、error、happy、notification、sweeping、carrying、sleeping),支持多代理并存并按会话独立追踪、取最高优先级状态显示。权限请求以右下角堆叠的气泡卡呈现,支持 Ctrl+Shift+Y / Ctrl+Shift+N 全局热键、三种处理模式(每次询问/仅问题提示/自动批准),并可通过 Telegram、飞书(Lark)做远程审批,Slack 仅推送通知。仪表盘(右键 → Open Dashboard)显示实时会话、事件和别名,可跳转到对应终端窗口;Orbit 环与 Dashboard 条展示订阅配额(本地 Claude 数据默认关闭,使用官方 status-line rate_limits 载荷)。Settings → Mobile / PWA 可生成带 token 的局域网配对链接,在手机上只读查看会话状态。自定义主题通过 node scripts/create-theme.js 脚手架创建,最少需 1 个带眼动的 SVG 加 7 个 GIF/APNG 文件,并可用 node scripts/validate-theme.js 校验。
- 跑长任务的 Claude Code 用户:启动重构或批量测试后离开电脑,等螃蟹睡觉或庆祝动画提醒回来,不必反复切回终端查看进度。
- 同时开多个代理的重度用户:Claude Code、Codex CLI、Cursor Agent 并行工作,Clawd 按会话独立追踪并用 1 个子代理戴耳机、2 个以上子代理抛球的动画区分负载。
- 在意权限安全的开发者:代理请求写文件或执行命令时,用桌面气泡或 Telegram/飞书远程一键 Allow/Deny,不必守在终端前。
- 远程/WSL 工作流用户:通过 Settings → Remote SSH 把钩子部署到远程服务器上的 Claude Code 或 Codex,本地 Clawd 仍能显示状态和权限气泡。
- 想量化自己 AI 编程使用情况的用户:用 Recap 按小时/天/月回顾已接受的代理活动,配合 Dashboard 查看订阅配额消耗。
- 主题爱好者:用
create-theme.js脚手架做出自己的角色,或直接导入已有的 Codex Pet zip 动画包。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
brew install --cask clawd-on-desk
- 安装说明涉及
- Windows · macOS · Linux
如何安装或部署这个 Agent?
普通用户从 GitHub Releases 下载预编译安装包:Windows 提供 x64 与 ARM64 的 Clawd-on-Desk-Setup-<version>-*.exe,macOS 提供 .dmg,Linux 提供 .AppImage 或 .deb。在 macOS 或 Linux x86_64 上也可用 Homebrew:brew install --cask clawd-on-desk。从源码运行需要 Node.js:git clone https://github.com/rullerzhou-afk/clawd-on-desk.git && cd clawd-on-desk && npm install && npm start。安装后首次启动会自动注册 Claude Code 与 Codex 钩子;其余代理集成需在 Settings → Agents 中按需安装。
如何使用这个 Agent?
安装并启动后,Clawd 即驻留桌面并自动同步 Claude Code / Codex 集成。要接入其他代理,右键打开 Settings… → Agents 选择对应代理安装钩子或插件。右键或托盘菜单可打开 Dashboard(实时会话)、Recap(活动回顾)、Mini Mode(贴边迷你模式)和 Do Not Disturb(免打扰)。权限气泡弹出时点击 Allow/Deny,或用 Ctrl+Shift+Y / Ctrl+Shift+N 热键;远程审批需在设置中配置 Telegram 或飞书渠道。主题更换在 Settings → Theme 中进行,可导入 Codex Pet zip 或选择自定义主题。移动端镜像在 Settings → Mobile / PWA 生成配对 URL,用手机浏览器打开即可。
这个 Agent 有哪些优点和局限?
- 代理覆盖面在同類项目中极为突出:除 Claude Code 和 Codex 的开箱即用集成外,还文档化了 Copilot、Gemini、Cursor、Qwen、Kiro、opencode、Hermes 等二十余种代理的具体钩子/插件接入方式。
- 权限审批是真正可操作的:桌面气泡、全局热键、Telegram/飞书远程 Allow/Deny 一应俱全,且对仅状态类代理明确保留原生权限流,不会误代决策。
- 多会话与子代理感知细腻:每个会话独立追踪,1 个子代理戴耳机、2 个以上抛球的映射让并发状态一目了然。
- 本地隐私边界清晰:Recap 只存最小化本地数据、不加遥测;移动 PWA 是 LAN-only 加 token 门控的只读镜像;Slack 密钥以 0600 权限存在本地 env 文件。
- 大量集成分阶段实现:Antigravity、Pi、CodeWhale、QoderWork、TraeCode 等是 state-only,没有权限气泡;部分集成还是实验性(DeepSeek Harness、TraeCode),采用前需查 known-limitations 表。
- 除 Claude Code 和 Codex 外,其他代理的钩子需逐个在 Settings → Agents 手动安装并保持同步,初始配置成本不低。
- Slack 渠道只能收通知,不能远程 Allow/Deny;移动 PWA 也是只读,浏览器内审批仍在路线图中。
- 从源码运行会拉取 Electron 构建工具链并生成庞大的 node_modules,仅适合贡献者或调试场景。
- Clawd 角色形象归 Anthropic 所有,属非官方粉丝项目;美术资源不受 AGPL-3.0 覆盖,二次分发需注意资产许可。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Clawd on Desk 当前 | 68 · 存在缺口 | 桌面应用免费 | ★ 6.8k | 1 天前 | JavaScript | Codex · Claude Code |
| T3 Code | 71 · 存在缺口 | — | ★ 63k | 今天 | TypeScript | Codex · Claude Code |
| Agentbox | 66 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 422 | 今天 | TypeScript | Codex · Claude Code |
| Peon Ping——AI 代理语音通知 | 64 · 存在缺口 | 命令行工具免费 | ★ 5.1k | 10 天前 | Shell | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
集成默认仅启用 Claude Code 与 Codex,其他集成需安装和启用;自动审批可选,外部审查命令默认关闭且只会把自动允许降级为人工卡片。Telegram、飞书/Lark 的远程决定也需配置。文档说明凭据存放、数据传递和部分清理方式,因此最小权限、确认、透明度、敏感数据处理与回滚得分较高但未满分:集成会改写本地 agent 配置并可产生远程审批或通知,且包清单中的第三方依赖没有提供安全审计证据。项目对代码和插画的授权范围、来源有说明,但发布者身份及更新责任仍不完全明确。
架构说明、已知限制和测试文件能支撑较连贯的产品描述,且限制文档列出具体行为与边界。依赖可用性只得 1 分:包清单显示 Electron、SDK 与多个运行时依赖,但样本未说明供应链审计或离线可用性。Telegram 故障码、超时和本地回退等有具体排查说明;不是每种集成都有同等详细的故障信息,因此失败消息得 2 分。
文档明确面向多种编码 agent、桌面平台、Remote SSH、WSL 和多语言用户,并提供自定义 HTTP agent 与主题入口。能力边界有专门文档,但支持范围广且各 agent 的审批、状态和会话行为差异较多;触发方式由 hooks、日志轮询及插件共同承担,说明了路径但未在本样本中完整列出每种触发条件。环境覆盖充分,平台细节和限制仍需逐项核对。
README、指南、项目架构文档及限制文档形成清晰的信息层级;安装和多平台入口有说明,但具体接入仍依赖多份指南。agent 名称和部分专用接口有稳定约定,广泛集成使一致性无法仅凭样本确认。示例、排障和限制较具体,AGPL-3.0 及插画例外也有清楚说明。版本号在 package.json 中可见,但样本没有变更日志;维护者名单和 issue/PR 路径存在,但维护责任范围及保障程度有限。
产品将 agent 活动显示为桌面动画、会话 HUD 和可选通知,并能提供权限卡片与远程审批,日常状态查看和审批具有实际用途。价值主张清楚,但对纯状态展示而言,桌面常驻和多项集成设置带来一定安装、配置与维护成本;样本没有量化节省时间或资源开销,因此得分为 2。
README 的功能概述能在架构说明、指南、限制文档和部分源码中找到对应依据;测试文件显示仓库具有静态资产审查及 Electron 相关测试,但本次未执行,且样本不是完整仓库。文档会标明哪些权限或平台行为尚未端到端验证,也会将推断与已观察限制分开陈述,事实与推论区分得较好。
- 这是基于不完整文件样本的静态审查;未执行应用或测试,不能据此确认运行时行为。
- 远程审批、通知与回复功能会把权限请求或用户回复发送到已配置的第三方服务;启用前应核对目标、凭据和自动发送行为。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
v1.6.0 Clawd v1.6.0 adds Windows computers as Remote SSH hosts, supports the Kiro IDE, and reminds you when Copilot CLI or Claude Desktop is waiting for your answer. The pet uses far less CPU when it is hidden, on scaled displays and while wearing accessories, and it can play small idle animations. Phones can pair by scanning a QR code, and the Windows installer, hooks and update flow got several fixes. Remote SSH …在 GitHub 查看 ↗ -
发布说明摘录
v1.5.0 Clawd v1.5.0 gives each phone its own pairing, moves Linux .deb updates to an official APT source, and animates the pet while Codex delegated subagents work. It also tidies the AI Coding Tools and Permissions & approval settings, adds support for community themes with author credits, shows Codex plan progress, and keeps Clawd's local server running when its default ports are unavailable. Linux updates - Official APT source (#1255, #1288; related #1221) — .deb installations keep update notifications, but the button now reads "Update with APT" and opens …在 GitHub 查看 ↗ -
发布说明摘录
v1.4.0 Clawd v1.4.0 reorganizes Settings into five focused tabs, reduces idle CPU use with sleep-aware rendering, and adds KiroCrew and Qoder CN integrations. It also adds opt-in external permission review, read-only phone approval summaries, local OpenCode/MiMo question answers, and herdr pane focus. Settings - Five-tab Settings redesign (#1218, #1220, #1179; related #969) — splits General into General, Pet, Notifications, Sessions, and Permissions & approval; moves Remote approval into the Permissions & approval tab with On this machine, …在 GitHub 查看 ↗
常见问题
Clawd on Desk 官网是什么?
Clawd on Desk 免费吗?
Clawd on Desk 开源吗?
Clawd on Desk 安全吗?
Clawd on Desk 还在维护吗?
Clawd on Desk 是谁开发的?
谢谢反馈,我们会据此改进页面。