Clawd on Desk

Clawd はデスクトップに住むペットで、AI コーディングエージェントが今何をしているかにリアルタイムで反応します。長いタスクを開始したら席を外し、Clawd が完了を知らせたら戻ってくるだけです。

プロンプトを入力すると考え、ツールが動くとタイピングし、サブエージェントが動くとヘッドホングルーヴや3ボールジャグリングになり、権限確認ではカードを表示し、タスク完了時には喜び、離席中は眠ります。組み込みテーマとして 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、Qoder と連携します。

機能

マルチエージェント対応

Claude Code — command hook と HTTP permission hook による完全統合
Codex CLI — official hooks を主経路にし、JSONL フォールバック（~/.codex/sessions/）も利用。自動登録され、実際の権限バブルに対応
Copilot CLI — ~/.copilot/hooks/hooks.json の command hook に対応
Gemini CLI — ~/.gemini/settings.json の command hook に対応（Clawd 起動時に自動登録、または npm run install:gemini-hooks）
Antigravity CLI (agy) — ~/.gemini/config/hooks.json の command hook に対応（Antigravity config がある場合は Clawd 起動時に自動登録、または npm run install:antigravity-hooks）。state-only のため、Clawd は agy の権限バブルを表示しません。Allow / Deny / Always-allow は agy 自身のターミナルメニューで選択します
Cursor Agent — ~/.cursor/hooks.json の Cursor IDE hooks に対応（Clawd 起動時に自動登録、または npm run install:cursor-hooks）
CodeBuddy — ~/.codebuddy/settings.json 経由で Claude Code 互換の command hook と HTTP permission hook に対応（Clawd 起動時に自動登録、または node hooks/codebuddy-install.js）
Kiro CLI — ~/.kiro/agents/ 配下のカスタムエージェント設定に command hook を注入。Clawd 起動時には Kiro 組み込みの kiro_default から再同期される clawd エージェントも自動作成されるため、kiro-cli --agent clawd または /agent swap clawd で挙動差を抑えながら hook を利用できます（Clawd 起動時に自動登録、または npm run install:kiro-hooks）。state hook は macOS と Windows で検証済みです。
Kimi Code CLI (Kimi-CLI) — ~/.kimi/config.toml の command hook（[[hooks]] エントリ）に対応（Clawd 起動時に自動登録、または npm run install:kimi-hooks）
Qwen Code — ~/.qwen/settings.json の command hook に対応（Clawd 起動時に自動登録、または npm run install:qwen-hooks）。状態追跡と Qwen PermissionRequest のデスクトップ権限バブルに対応します
opencode — ~/.config/opencode/opencode.json 経由の plugin integration に対応（Clawd 起動時に自動登録）。遅延のないイベントストリーミング、Allow/Always/Deny 付きの権限バブル、task tool による並列サブエージェント生成時の building アニメーションに対応
Pi — ~/.pi/agent/extensions/clawd-on-desk のグローバル extension で連携します（Clawd 起動時に自動登録、または npm run install:pi-extension）。インタラクティブな Pi セッションのライフサイクルとツール活動だけを状態同期し、Pi のデフォルト YOLO 動作を維持します
OpenClaw — ~/.openclaw/openclaw.json の plugin path で state-only 連携します（OpenClaw config が既にある場合は Clawd 起動時に自動登録、または npm run install:openclaw-plugin）。Phase 1 はローカル openclaw tui --local セッションのアニメーションのみを対象とし、権限バブルやターミナルフォーカスには対応しません
Hermes Agent — Hermes の管理 plugin ディレクトリ経由の plugin integration（Hermes インストール済みの場合は Clawd 起動時に自動登録、または npm run install:hermes-plugin）。状態、セッション、SessionEnd、ターミナルフォーカスに対応
Qoder — ~/.qoder/settings.json の command hook で state-only 連携します（~/.qoder/ ディレクトリがある場合は Clawd 起動時に自動登録、または npm run install:qoder-hooks）。Phase 1 はアニメーションのみを対象とし、権限リクエストは通知として観察するだけで、Clawd は権限バブルを表示せず代わりに応答もしません。Allow / Deny は Qoder 自身の権限フローで選択します
複数エージェントの共存 — すべてのエージェントを同時に動かせます。Clawd は各セッションを個別に追跡します

アニメーションと操作

リアルタイムな状態認識 — agent hook とログポーリングが Clawd のアニメーションを自動で切り替えます
12 種類のアニメーション状態 — idle、thinking、typing、building、headphones groove、multi-subagent juggling、error、happy、notification、sweeping、carrying、sleeping
Codex Pet インポート — Settings... → Theme から Codex Pet zip パッケージをインポートすると、Clawd が atlas アニメーションを管理テーマに変換します
視線追従 — idle 状態では Clawd がカーソルを追い、体の傾きや影の伸びも変化します
睡眠シーケンス — 60 秒アイドルが続くと、あくび、うとうと、倒れ込み、睡眠へ移行します。マウス移動で驚いて起きるアニメーションが再生されます
クリックリアクション — ダブルクリックでつつき、4 回クリックでじたばたします
どの状態からでもドラッグ — いつでも Clawd をつかめます（Pointer Capture により素早いフリックでも取り落としません）。離すと元の状態へ戻ります
Mini mode — 右端へドラッグ、または右クリックの「Mini Mode」で有効化。Clawd が画面端に隠れ、ホバーで顔を出し、mini 通知やお祝い、放物線ジャンプの遷移を行います

権限バブル

アプリ内権限レビュー — Claude Code、Codex CLI、CodeBuddy、opencode がツール権限を要求すると、ターミナルで待つ代わりに Clawd がフローティングバブルカードを表示します
許可 / 拒否 / エージェント固有の追加操作 — ワンクリックで承認または拒否できます。対応エージェントでは permission rule や Always 操作も利用できます
グローバルホットキー — 最新の権限バブルに対して Ctrl+Shift+Y で許可、Ctrl+Shift+N で拒否（バブル表示中だけ登録されます）
スタックレイアウト — 複数の権限リクエストは右下から上方向へ積み重なります
自動消去 — 先にターミナルで回答した場合、バブルは自動的に消えます
エージェントごとの切り替え — Settings... → Agents でエージェントを選び、Show pop-up bubbles をオフにすると、そのエージェント自身のターミナル/TUI に確認を残せます

セッション情報

マルチセッション追跡 — すべてのエージェントのセッションから、優先度の最も高い状態を解決します
サブエージェント認識 — サブエージェント 1 個で headphones groove、2 個以上で three-ball juggling
Sessions dashboard + HUD — 右クリックまたは tray → Open Dashboard から live session、最近のイベント、エイリアス、ターミナルジャンプを確認できます。Clawd の近くにはコンパクトな HUD が表示され、現在の live session を見失いません
ターミナルフォーカス — Dashboard/HUD の操作で特定セッションのターミナルへジャンプできます。notification/attention 状態では関連するターミナルを自動で前面にします
プロセス生存確認 — 対応エージェントのプロセスがクラッシュまたは終了したことを検知し、孤立セッションを片付けます
起動時リカバリー — Clawd の再起動時に対応エージェントがまだ動いていれば、眠らずに起きたままになります

モバイルコンパニオン（PWA）

スマホでライブミラー — Settings... → Mobile / PWA を有効にし、スマホでペアリング URL を開くと、Clawd Mobile ウェブアプリがエージェントのセッションと状態をリアルタイムに表示します
読み取り専用設計 — LAN ブリッジは状態のブロードキャストのみを行い、スマホから PC を操作することはできません（リモート承認はロードマップにあります）
LAN 限定 + トークン保護 — ペアリングにはトークンが必要で、トークンは猶予期間つきで自動ローテーションされ、ワンクリックで再生成・リセットできます
インストール可能 — PWA なので、ホーム画面に追加すればアプリのように使えます

モバイルコンパニオンのラインは、最初のプロトタイプからトークンローテーションまで、コアコントリビューター @Bynlk が作り上げ、リードしています。ネイティブ Android アプリを備えた姉妹プロジェクト clawd-on-mobile も同氏がメンテナンスしています。

システム

クリック透過 — 透明部分のクリックは背面ウィンドウへ通り、Clawd の体だけが操作対象になります
位置の記憶 — 再起動後も最後に置いた場所を覚えます（mini mode を含む）
単一インスタンスロック — Clawd ウィンドウの重複起動を防ぎます
自動起動 — Claude Code の SessionStart hook により、Clawd が起動していない場合に自動で起動できます
Do Not Disturb — 右クリックまたは tray メニューから sleep mode に入り、起こすまで hook event をすべて抑制します。DND 中は権限バブルも抑制されます。Codex と opencode はネイティブプロンプトに戻り、Claude Code と CodeBuddy は組み込みの権限フローに戻ります。Antigravity と Pi は state-only です
効果音 — タスク完了や権限リクエスト時に短い音を鳴らします（右クリックメニューで切り替え、10 秒クールダウン、DND 中は自動ミュート）
システムトレイ — サイズ変更（S/M/L）、DND mode、言語切り替え、自動起動、更新確認
i18n — English、簡体中文、繁体中文、Korean、Japanese UI。右クリックメニューまたは tray から切り替えできます
自動更新 — GitHub Releases を確認します。Windows では終了時に NSIS 更新を適用し、macOS/Linux では clone したリポジトリから実行している場合に git pull + restart を行います

アニメーション

_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}

event-to-state mapping、mini mode、クリックリアクションの詳細: docs/guides/state-mapping.md

マルチディスプレイ

Clawd はマルチモニター環境に適応します。起動したディスプレイに合わせて比例サイズを決め、縦長モニターでは読みやすさを保つために上限付きで拡大し、ディスプレイ間のドラッグにも対応します。

_{実際のマルチモニター挙動は、このリポジトリ内のデモ動画で確認できます。}

クイックスタート

通常利用では、GitHub Releases から最新のビルド済みインストーラーをダウンロードしてください。

Windows: Clawd-on-Desk-Setup-<version>-x64.exe または Clawd-on-Desk-Setup-<version>-arm64.exe
macOS: .dmg
Linux: .AppImage または .deb

インストール後に Clawd を起動してください。対応エージェントの hook/plugin は起動時に自動同期されます。

ソースからの実行は、コントリビュート、未リリースコードのテスト、または連携のデバッグを行う場合だけを推奨します。ソースインストールでは Electron/build tooling をダウンロードし、大きな node_modules ツリーが作成されることがあります。

# リポジトリを clone
git clone https://github.com/rullerzhou-afk/clawd-on-desk.git
cd clawd-on-desk

# 依存関係をインストール
npm install

# Clawd を起動（起動時に Claude Code hooks を自動登録）
npm start

Claude Code、Codex CLI、Copilot CLI は自動登録される hook により、そのまま動作します。Gemini CLI、Antigravity CLI (agy)、Cursor Agent、CodeBuddy、Kiro CLI、Kimi Code CLI (Kimi-CLI)、Qwen Code、opencode、Pi、OpenClaw、Hermes Agent、Qoder は、インストール済みかつ初期化済みであれば Clawd 起動時に自動登録されます。Remote SSH、WSL、macOS/Linux のプラットフォーム別メモも含めた詳細: docs/guides/setup-guide.md

リモートサーバーで Claude Code / Codex CLI を動かし、状態と権限バブルをローカル Clawd に転送したい場合は、アプリ内の Settings → Remote SSH → One-click deploy を使います。完全な手順、Doctor の境界、FAQ はこちら: docs/guides/guide-remote-ssh.md

公式の Codex + WSL ステータス、Clawd の現在の実装境界、そして誤解しやすい理由については、こちらを参照してください: docs/guides/codex-wsl-clarification.md

既知の制限

一部のエージェントには機能差があります（権限バブルなし、ポーリング遅延、ターミナルフォーカスなしなど）。完全な表はこちら: docs/guides/known-limitations.md

カスタムテーマ

Clawd はカスタムテーマに対応しています。標準のカニを、自分のキャラクターやアニメーションに置き換えられます。既存の Codex Pet パッケージがある場合は、Settings... → Theme → Import pet zip から取り込むと、Clawd が atlas を管理テーマへ自動変換します。

クイックスタート:

テーマを scaffold します。
```
node scripts/create-theme.js my-theme
# または
npm run create-theme -- my-theme
```
引数なしでも動作します。ユーザーテーマディレクトリ内に、次に利用可能な my-theme scaffold を作成します。
theme.json を編集し、アセット（SVG、GIF、APNG、WebP、PNG、JPG、JPEG）を作成します
Clawd を再起動するか、Settings... → Theme → 自分のテーマを選択します

最小構成のテーマ: SVG 1 個（視線追従付き idle）+ GIF/APNG 7 個（thinking、working、error、happy、notification、sleeping、waking）。視線追従を無効にすれば、すべての状態で任意の形式を利用できます。

配布前にテーマを検証してください。

node scripts/validate-theme.js path/to/your-theme

Settings... → Theme のテーマカードには、Tracked idle、Static theme、Mini、Direct sleep、No reactions などの capability badge が表示されるため、ユーザーは切り替える前にテーマの対応範囲を確認できます。

初心者から上級者までの段階別パス、theme.json のフィールドリファレンス、アセットガイドラインを含む完全な作成ガイドは docs/guides/guide-theme-creation.md を参照してください。

サードパーティ製 SVG ファイルは、セキュリティのため自動で sanitize されます。

Roadmap

今後検討したい項目です。

codex.exe PID からのプロセスツリー lookup による Codex ターミナルフォーカス
テーマレジストリとアプリ内ダウンロード
アプリのクリーン削除用 hook uninstall script
モバイルコンパニオン: スマホからのリモート権限承認（@Bynlk 主導で進行中）

コントリビュート

Clawd on Desk はコミュニティ主導のプロジェクトです。バグ報告、機能案、Pull Request を歓迎します。相談したい場合は issue を開くか、直接 PR を送ってください。

メンテナー

_{@rullerzhou-afk
鹿鹿 · creator}

_{@YOIMIYA66
maintainer}

_{@Bynlk
core contributor · Mobile / PWA}

コントリビューター

Clawd をより良くしてくれたすべての方に感謝します。

_{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	_linnin233
_xiyouMc	_Bynlk	_zxypro1	_NeroAyase	_divergentD	_Ne9roni	_QingXB
_藤知	_Tsdsj	_godlockin	_sLingli	_ustin-star	_cod3hulk	_lxgxhsy
_{rebootcrab-blip}	_zhaoxv210	_serenNan	_{IatomicreactorI}	_quantai1314	_Git-creat7	_undownding
_chrono-meta