Start a long task, walk away, and come back when the crab tells you it's done. Clawd thinks while you prompt, types while tools run, juggles when subagents pile up, pops a card when a tool needs your approval, and dozes off when you step away.
Features
- Live agent status: 12 animated states driven by agent hooks and logs, plus eye tracking, a sleep sequence, click reactions, and a mini mode that peeks from the screen edge
- Works with your tools: Claude Code, Codex, Copilot, Gemini, Cursor, opencode, Kiro, Qwen and 20+ more, each session tracked side by side
- Permission bubbles: Allow or Deny tool requests from a floating card or a global hotkey, or switch to auto-approve
- Sessions at a glance: a HUD next to the pet, a dashboard of every live session with one-click jump to its terminal, quota rings, and a private local recap
- Away from your desk: approve from Telegram or Feishu/Lark, get Slack notifications, or follow sessions on your phone with the read-only mobile PWA
- Make it yours: Clawd, Calico and Cloudling built in, official themes to download, Codex Pet imports, or a theme of your own
- Runs where you code: Windows (x64 and ARM64), macOS and Linux, plus Remote SSH and WSL, with the UI in 7 languages
Every feature in detail: docs/guides/features.md
Quick Start
Download the latest installer from GitHub Releases:
| Platform | Download |
|---|
| Windows | Clawd-on-Desk-Setup--x64.exe or -arm64.exe |
| macOS | .dmg, or brew install --cask clawd-on-desk |
| Linux | .AppImage or .deb (Homebrew also works on x86_64) |
Launch Clawd and it starts reacting right away: Claude Code and Codex are connected on first launch. Every other agent is one click away in Settings → AI Coding Tools.
Run from source
Only needed for contributing, testing unreleased code, or debugging integrations. Source installs download Electron and build tooling, so node_modules gets large.
# Clone the repo
git clone https://github.com/rullerzhou-afk/clawd-on-desk.git
cd clawd-on-desk
# Install dependencies
npm install
# Start Clawd (auto-registers Claude Code and Codex hooks on launch)
npm start
Prerequisites, Remote SSH, WSL, and macOS / Linux notes: setup guide
Supported Agents
> 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 and Codex CLI are set up on first launch; install any other integration from Settings → AI Coding Tools and Clawd keeps it synced. Other local tools can report through the custom HTTP agent endpoint. Per-agent details are in supported agents, and gaps such as agents without permission bubbles are in known limitations.
Themes
<img src="assets/gif/clawd-idle.gif" width="100" />Idle
<img src="assets/gif/clawd-thinking.gif" width="100" />Thought Bubble
<img src="assets/gif/clawd-typing.gif" width="100" />Typing
<img src="assets/gif/clawd-building.gif" width="100" />Building
<img src="assets/gif/clawd-headphones-groove.gif" width="100" />1 Subagent
<img src="assets/gif/clawd-juggling.gif" width="100" />2+ Subagents
<img src="assets/gif/calico-idle.gif" width="80" />Calico Idle
<img src="assets/gif/calico-thinking.gif" width="80" />Calico Thinking
<img src="assets/gif/calico-typing.gif" width="80" />Calico Typing
<img src="assets/gif/calico-building.gif" width="80" />Calico Building
<img src="assets/gif/calico-juggling.gif" width="80" />Calico Juggling
<img src="assets/gif/calico-conducting.gif" width="80" />Calico Conducting
<img src="assets/gif/cloudling-idle.gif" width="120" />Cloudling Idle
<img src="assets/gif/cloudling-thinking.gif" width="120" />Cloudling Thinking
<img src="assets/gif/cloudling-typing.gif" width="120" />Cloudling Typing
<img src="assets/gif/cloudling-building.gif" width="120" />Cloudling Building
<img src="assets/gif/cloudling-juggling.gif" width="120" />Cloudling Juggling
<img src="assets/gif/cloudling-conducting.gif" width="120" />Cloudling Conducting
Clawd ships with Clawd (pixel crab), Calico (三花猫) and Cloudling (云宝). Hash Sage (哈希仙人) and Whale-chan (鲸鱼娘) are optional official themes in Settings → Theme, where you can also import a Codex Pet zip. To draw your own, run npm run create-theme -- my-theme and follow the theme creation guide. Which event plays which animation: state mapping.
Community tool: Live2Pet by @receyuki turns Live2D models into Clawd themes.
Guides
Join our Discord community to get help, share themes and desktop setups, or discuss ideas. English and Chinese are welcome. Please report bugs through GitHub Issues so we can track them.
WeChat Official Account
WeChat Group
<img src="assets/readme/wechat-official-account.jpg" width="200" height="200" alt="QR code for the WeChat official account 鹿鹿的学习笔记" /><b>鹿鹿的学习笔记</b>Scan to follow on WeChat
<img src="assets/readme/wechat-group-contact.png" width="200" height="200" alt="WeChat contact QR code for a group invite" /><b>Join the WeChat group</b>Scan to add 云宝.bot on WeChatOnce your friend request is accepted,we’ll invite you to the group
Contributing
Clawd on Desk is a community-driven project. Bug reports, feature ideas, and pull requests are all welcome — open an issue to discuss or submit a PR directly. See CONTRIBUTING.md for how to run from source, add a translation, or integrate a new agent.
Maintainers
Contributors
Thanks to everyone who has helped make Clawd better:
Acknowledgments
License
Source code is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
Artwork and bundled theme assets (including assets/ and themes/*/assets/) are NOT covered by AGPL-3.0. All rights reserved by their respective copyright holders. See assets/LICENSE and the notices below for details.
- Clawd character is the property of Anthropic. This is an unofficial fan project, not affiliated with or endorsed by Anthropic.
- Calico cat (三花猫) artwork by 鹿鹿 (@rullerzhou-afk). All rights reserved.
- Cloudling (云宝) artwork by 鹿鹿 (@rullerzhou-afk). All rights reserved. Cloudling's visual direction includes an homage to the OpenAI Codex logo; Codex/OpenAI marks remain the property of OpenAI, and this project is not affiliated with or endorsed by OpenAI.
- Hash Sage (哈希仙人) is distributed as an optional official theme from the
rullerzhou-afk/clawd-themes repository. Its artwork is copyright 鹿鹿 (@rullerzhou-afk); see the theme package for its license and full attribution. It is not covered by this project's AGPL-3.0 source license.
- Whale-chan (鲸鱼娘) is distributed as an optional official theme from the
rullerzhou-afk/clawd-themes repository. Rights in the original character design, setting and upstream materials remain with their creators; the theme credits ZipZipPipe and 上善无形 as named by Neko3000/deepseek-whalechan. New animation and effects by 鹿鹿 (@rullerzhou-afk) are licensed under CC BY-NC-SA 4.0; see the theme package for full terms. It is an unofficial, non-commercial fan work, not affiliated with or endorsed by DeepSeek, and it is not covered by this project's AGPL-3.0 source license.
- Third-party contributions: copyright retained by respective artists.
No cryptocurrency. This project has no token, coin, NFT, or airdrop, and is not affiliated with any cryptocurrency project.
