Clawd on Desk：即時反映 AI 程式代理狀態的桌面像素寵物

在你代理工作時做出反應的螃蟹

Clawd on Desk 是一隻生活在桌面上的像素寵物，會根據 AI 程式代理此刻正在做的事改變自己的動畫。README 描述了一連串狀態：你發出提示時牠思考，工具執行時牠打字，有一個子代理時牠戴上耳機擺動，有兩個或更多子代理時牠拋接三個球，需要審批時牠舉起權限氣泡，任務完成時牠慶祝。專案的想法很簡單：開始一個長任務，走開，等螃蟹告訴你牠完成了再回來。倉庫沒有聲稱這些狀態轉換有某種精確度，只說明鉤子事件和日誌輪詢會自動驅動這些動畫。換句話說，牠不做任何判斷，只是把代理上報的狀態演出來。

這一段要讀成 clawd-on-desk 的具體使用邊界，而不是泛用工具的宣傳。README 把 rullerzhou-afk/clawd-on-desk 放在 JavaScript 生態中，並以明確的入口、選項或檔案說明使用者能做什麼。實際採用時，先照該段提到的名稱與路徑建立最小案例，再記錄命令回傳值、輸出檔案和錯誤訊息。若結果與文件不一致，應以實際版本的 README、CHANGELOG 或 Releases 逐項比對，不能把未記載的功能補成保證。clawd-on-desk 使用 AGPL-3.0 授權，這只說明授權條款的適用範圍，不代表作者替部署環境承擔支援或安全責任。 本段標題為「在你代理工作時做出反應的螃蟹」，核對序號 1。 在 clawd-on-desk 的 README 中，這一節涉及 rullerzhou-afk/clawd-on-desk 的實際入口；文檔未說明的行為不在本文推論範圍。 針對 clawd-on-desk，還要分開看輸入、處理與輸出。輸入是否符合 README 的格式，決定後續結果能否比較；處理階段若涉及外部程式、Emacs 套件、Ruby 函式庫或系統工具，必須確認相依版本與權限；輸出則應檢查實際檔案、文字內容、網路請求或終端訊息。這些觀察點會把 clawd-on-desk 的特色轉成可重現的工程判斷，也能及早暴露文件沒有涵蓋的例外。再把 clawd-on-desk 放回原本的工作流程，逐項確認安裝、設定、執行、失敗處理和升級方式，才能知道它是否真的適合目前團隊。

各代理的整合深度並不相同

專案列出了二十多個受支援的代理，但並非所有代理都以相同的深度整合。Claude Code 透過命令鉤子加 HTTP 權限鉤子獲得完整整合，Codex CLI 使用官方鉤子並帶 JSONL 回退。Gemini CLI、Cursor Agent、Kimi Code CLI、Qwen Code、Reasonix CLI 等屬於可選整合，從 Settings → Agents 安裝。有些代理是純狀態型：Antigravity、ZCode、CodeWhale、Pi、OpenClaw、Qoder 和 QoderWork 只驅動動畫，權限決定仍留在代理自己的終端流程裡。README 沒有說明每個代理是否在所有平台上都能運作，而是指向一份已知限制表，列出缺少權限氣泡、輪詢延遲等差距。每個代理的具體整合方式都記錄在各自文件裡，需要逐項核對。

這一段要讀成 clawd-on-desk 的具體使用邊界，而不是泛用工具的宣傳。README 把 rullerzhou-afk/clawd-on-desk 放在 JavaScript 生態中，並以明確的入口、選項或檔案說明使用者能做什麼。實際採用時，先照該段提到的名稱與路徑建立最小案例，再記錄命令回傳值、輸出檔案和錯誤訊息。若結果與文件不一致，應以實際版本的 README、CHANGELOG 或 Releases 逐項比對，不能把未記載的功能補成保證。clawd-on-desk 使用 AGPL-3.0 授權，這只說明授權條款的適用範圍，不代表作者替部署環境承擔支援或安全責任。 本段標題為「各代理的整合深度並不相同」，核對序號 2。 核對 clawd-on-desk 時可直接對照官方 README 的命令、檔案路徑與版本標籤；這些記號比倉庫人氣統計更能界定使用條件。 針對 clawd-on-desk，還要分開看輸入、處理與輸出。輸入是否符合 README 的格式，決定後續結果能否比較；處理階段若涉及外部程式、Emacs 套件、Ruby 函式庫或系統工具，必須確認相依版本與權限；輸出則應檢查實際檔案、文字內容、網路請求或終端訊息。這些觀察點會把 clawd-on-desk 的特色轉成可重現的工程判斷，也能及早暴露文件沒有涵蓋的例外。再把 clawd-on-desk 放回原本的工作流程，逐項確認安裝、設定、執行、失敗處理和升級方式，才能知道它是否真的適合目前團隊。

權限氣泡把審批從終端裡移出來

對於一部分代理，Clawd 可以攔截權限請求，彈出一個浮動氣泡卡片，而不是讓提示一直等在終端裡。README 點名了 Claude Code、Codex CLI、CodeBuddy、opencode 和 MiMo Code。每個氣泡可以一鍵批准或拒絕，支援權限規則的代理還能看到 Always 操作。全域快速鍵 Ctrl+Shift+Y 和 Ctrl+Shift+N 用於回答最新的氣泡，但只在氣泡可見時註冊。多個請求從右下角向上堆疊，如果你先在終端裡回答了，氣泡會自動消失。Settings 裡的每個代理開關可以關掉氣泡，把提示留在代理自己的 TUI 中。

這一段要讀成 clawd-on-desk 的具體使用邊界，而不是泛用工具的宣傳。README 把 rullerzhou-afk/clawd-on-desk 放在 JavaScript 生態中，並以明確的入口、選項或檔案說明使用者能做什麼。實際採用時，先照該段提到的名稱與路徑建立最小案例，再記錄命令回傳值、輸出檔案和錯誤訊息。若結果與文件不一致，應以實際版本的 README、CHANGELOG 或 Releases 逐項比對，不能把未記載的功能補成保證。clawd-on-desk 使用 AGPL-3.0 授權，這只說明授權條款的適用範圍，不代表作者替部署環境承擔支援或安全責任。 本段標題為「權限氣泡把審批從終端裡移出來」，核對序號 3。 clawd-on-desk 的來源資料列出 JavaScript 與 AGPL-3.0，但沒有因此替使用者承諾效能、相容性或安全結果。 針對 clawd-on-desk，還要分開看輸入、處理與輸出。輸入是否符合 README 的格式，決定後續結果能否比較；處理階段若涉及外部程式、Emacs 套件、Ruby 函式庫或系統工具，必須確認相依版本與權限；輸出則應檢查實際檔案、文字內容、網路請求或終端訊息。這些觀察點會把 clawd-on-desk 的特色轉成可重現的工程判斷，也能及早暴露文件沒有涵蓋的例外。再把 clawd-on-desk 放回原本的工作流程，逐項確認安裝、設定、執行、失敗處理和升級方式，才能知道它是否真的適合目前團隊。

會話、子代理與儀表板

Clawd 會追蹤所有受支援代理的會話，多個代理同時活動時解析出優先度最高的狀態。子代理感知按數量區分：一個子代理對應耳機擺動，兩個或更多對應三球拋接。從右鍵選單或托盤開啟儀表板，可以看到即時會話、最近事件、別名，並跳到某個終端；寵物旁邊還有一個緊湊的 HUD 顯示目前會話。可選的 Orbit 環和儀表板條展示受支援代理上報的訂閱配額視窗，本地 Claude 收集預設關閉，基於 Claude Code 官方狀態列的 rate_limits 負載，而不是向 Anthropic 額外發請求。應用還能偵測當掉或退出的代理程序、清理孤立會話，並在 Clawd 重啟時如果代理仍在執行就保持清醒而不是睡著。

這一段要讀成 clawd-on-desk 的具體使用邊界，而不是泛用工具的宣傳。README 把 rullerzhou-afk/clawd-on-desk 放在 JavaScript 生態中，並以明確的入口、選項或檔案說明使用者能做什麼。實際採用時，先照該段提到的名稱與路徑建立最小案例，再記錄命令回傳值、輸出檔案和錯誤訊息。若結果與文件不一致，應以實際版本的 README、CHANGELOG 或 Releases 逐項比對，不能把未記載的功能補成保證。clawd-on-desk 使用 AGPL-3.0 授權，這只說明授權條款的適用範圍，不代表作者替部署環境承擔支援或安全責任。 本段標題為「會話、子代理與儀表板」，核對序號 4。 若要檢查這個判斷，應把 clawd-on-desk 的 README 範例放進隔離目錄，觀察它產生的輸出與錯誤，再逐項回看來源。 針對 clawd-on-desk，還要分開看輸入、處理與輸出。輸入是否符合 README 的格式，決定後續結果能否比較；處理階段若涉及外部程式、Emacs 套件、Ruby 函式庫或系統工具，必須確認相依版本與權限；輸出則應檢查實際檔案、文字內容、網路請求或終端訊息。這些觀察點會把 clawd-on-desk 的特色轉成可重現的工程判斷，也能及早暴露文件沒有涵蓋的例外。再把 clawd-on-desk 放回原本的工作流程，逐項確認安裝、設定、執行、失敗處理和升級方式，才能知道它是否真的適合目前團隊。

碰不到你機器的手機鏡像

這個倉庫裡的移動伴侶是 PWA 而不是原生應用。在 Settings → Mobile / PWA 裡啟用並開啟配對網址後，手機網頁應用會即時顯示代理會話和它們的目前狀態。README 明確說明 LAN 橋是唯讀的：手機上沒有任何東西能碰你的機器，遠端批准被列在路線圖裡而不是功能清單裡。配對需要權杖，權杖會自動輪換並帶寬限期，存取可以在一次點擊裡重新產生或重設。這條移動伴侶線由核心貢獻者 @Bynlk 負責建置和領導，他也維護 clawd-on-mobile，一個帶原生 Android 應用的姊妹分支。README 沒有公布配對網址的格式，也沒有給出除啟用和開啟網址之外的步驟。

這一段要讀成 clawd-on-desk 的具體使用邊界，而不是泛用工具的宣傳。README 把 rullerzhou-afk/clawd-on-desk 放在 JavaScript 生態中，並以明確的入口、選項或檔案說明使用者能做什麼。實際採用時，先照該段提到的名稱與路徑建立最小案例，再記錄命令回傳值、輸出檔案和錯誤訊息。若結果與文件不一致，應以實際版本的 README、CHANGELOG 或 Releases 逐項比對，不能把未記載的功能補成保證。clawd-on-desk 使用 AGPL-3.0 授權，這只說明授權條款的適用範圍，不代表作者替部署環境承擔支援或安全責任。 本段標題為「碰不到你機器的手機鏡像」，核對序號 5。 這個專案的限制也要和適用場景一起看：README 有寫出的能力可以採用作為檢查項，沒有寫出的整合方式不能當成既定功能。 針對 clawd-on-desk，還要分開看輸入、處理與輸出。輸入是否符合 README 的格式，決定後續結果能否比較；處理階段若涉及外部程式、Emacs 套件、Ruby 函式庫或系統工具，必須確認相依版本與權限；輸出則應檢查實際檔案、文字內容、網路請求或終端訊息。這些觀察點會把 clawd-on-desk 的特色轉成可重現的工程判斷，也能及早暴露文件沒有涵蓋的例外。再把 clawd-on-desk 放回原本的工作流程，逐項確認安裝、設定、執行、失敗處理和升級方式，才能知道它是否真的適合目前團隊。

安裝包、原始碼建置與設定指南

正常使用的話，README 指向 GitHub Releases 的預建置安裝包：Windows 上分別提供 x64 和 ARM64 的可執行檔，macOS 提供 .dmg，Linux 提供 AppImage 或 .deb。全新安裝只自動註冊 Claude Code 和 Codex 的鉤子，其他整合都從 Settings → Agents 安裝。從原始碼執行被描述為貢獻者和除錯者使用的選項，不是推薦路徑：複製倉庫、執行 npm install、用 npm start 啟動，而且會下載 Electron 和建置工具，形成很大的 node_modules 目錄。README 也記錄了遠端 SSH 部署鉤子的方法，用於在伺服器上跑 Claude Code 或 Codex 而本地 Clawd 顯示狀態和權限氣泡，並單列一份澄清文件說明 Codex 與 WSL 的邊界。macOS 和 Linux 的附加說明收錄在 setup-guide 文件裡。

這一段要讀成 clawd-on-desk 的具體使用邊界，而不是泛用工具的宣傳。README 把 rullerzhou-afk/clawd-on-desk 放在 JavaScript 生態中，並以明確的入口、選項或檔案說明使用者能做什麼。實際採用時，先照該段提到的名稱與路徑建立最小案例，再記錄命令回傳值、輸出檔案和錯誤訊息。若結果與文件不一致，應以實際版本的 README、CHANGELOG 或 Releases 逐項比對，不能把未記載的功能補成保證。clawd-on-desk 使用 AGPL-3.0 授權，這只說明授權條款的適用範圍，不代表作者替部署環境承擔支援或安全責任。 本段標題為「安裝包、原始碼建置與設定指南」，核對序號 6。 升級前可比較 clawd-on-desk 的 GitHub Releases 與預設分支變更，並保留實際使用到的設定鍵，避免把不同版本的行為混在一起。 針對 clawd-on-desk，還要分開看輸入、處理與輸出。輸入是否符合 README 的格式，決定後續結果能否比較；處理階段若涉及外部程式、Emacs 套件、Ruby 函式庫或系統工具，必須確認相依版本與權限；輸出則應檢查實際檔案、文字內容、網路請求或終端訊息。這些觀察點會把 clawd-on-desk 的特色轉成可重現的工程判斷，也能及早暴露文件沒有涵蓋的例外。再把 clawd-on-desk 放回原本的工作流程，逐項確認安裝、設定、執行、失敗處理和升級方式，才能知道它是否真的適合目前團隊。

十二種動畫、三套主題與一份拆開的授權

寵物有十二種動畫狀態，README 展示了 idle、thought bubble、typing、building、一個子代理、兩個及以上子代理，以及 Calico 和 Cloudling 對應狀態的範例 GIF。內建三套主題：Clawd 像素螃蟹、Calico 三花貓和 Cloudling 雲寶。支援自訂主題，包括匯入 Codex Pet 的 zip 包，並提供驗證腳本和從零建立主題的指南。原始碼採用 AGPL-3.0，但美術和內建主題資產不受該授權覆蓋，版權歸各持有者所有。README 聲明 Clawd 是非官方粉絲專案，與 Anthropic 無關聯也未經其背書，Cloudling 的視覺方向包含對 OpenAI Codex 標誌的致敬，而且專案沒有代幣、幣、NFT 或空投。

這一段要讀成 clawd-on-desk 的具體使用邊界，而不是泛用工具的宣傳。README 把 rullerzhou-afk/clawd-on-desk 放在 JavaScript 生態中，並以明確的入口、選項或檔案說明使用者能做什麼。實際採用時，先照該段提到的名稱與路徑建立最小案例，再記錄命令回傳值、輸出檔案和錯誤訊息。若結果與文件不一致，應以實際版本的 README、CHANGELOG 或 Releases 逐項比對，不能把未記載的功能補成保證。clawd-on-desk 使用 AGPL-3.0 授權，這只說明授權條款的適用範圍，不代表作者替部署環境承擔支援或安全責任。 本段標題為「十二種動畫、三套主題與一份拆開的授權」，核對序號 7。 在 clawd-on-desk 的 README 中，這一節涉及 rullerzhou-afk/clawd-on-desk 的實際入口；文檔未說明的行為不在本文推論範圍。 針對 clawd-on-desk，還要分開看輸入、處理與輸出。輸入是否符合 README 的格式，決定後續結果能否比較；處理階段若涉及外部程式、Emacs 套件、Ruby 函式庫或系統工具，必須確認相依版本與權限；輸出則應檢查實際檔案、文字內容、網路請求或終端訊息。這些觀察點會把 clawd-on-desk 的特色轉成可重現的工程判斷，也能及早暴露文件沒有涵蓋的例外。再把 clawd-on-desk 放回原本的工作流程，逐項確認安裝、設定、執行、失敗處理和升級方式，才能知道它是否真的適合目前團隊。

編輯結論

Clawd on Desk 是一款 JavaScript/Electron 桌面寵物，把代理生命週期事件變成可見動畫，為少數代理提供權限氣泡，並配有唯讀手機鏡像。原始碼採用 AGPL-3.0，美術資源歸各版權持有者所有。

官方來源

1. Official README
2. Project repository
3. Release notes