技能包

Crabbox:給 agent 一台隨取盒子跑測試、建置與 UI 檢查

最適合讓 agent 或你自己把測試、建置和 UI 檢查放到一台隨取的雲端盒子、本機 VM/容器或既有機器上跑,同時繼續在本機編輯;首次使用前最重要的前提是本機必須先裝好 Docker 或 Podman,CLI 也需另行安裝。

官方來源 · openclaw/crabbox

安裝

npx skills add openclaw/crabbox --skill crabbox

Crabbox 最適合在 coding agent 一邊編輯本機程式碼的同時,把測試、建置或 UI 檢查交給一台隨取的遠端機器去跑;上手前最重要的前提是:你的機器上要能安裝 CLI,本機容器快速路徑還必須先安裝並啟動 Docker 或 Podman。

適合誰

  • 適合讓 agent 或自己在雲端盒子、本機 VM/容器或既有機器上跑測試、建置和 UI 檢查,同時繼續在本機編輯程式碼的人。
  • Crabbox 是一個 CLI,提供三種形態的盒子:雲端盒子、本機 VM 或容器、以及你自己既有的機器。
  • 本機容器快速路徑要求本機已安裝並執行 Docker 或 Podman;走 SSH 工作流程則要求本機具備 git、ssh、ssh-keygen、rsync 和 curl。不滿足這些前提時,官方證據未說明其他可用方式。
  • 雲端盒子是否需要帳號、收費方式、支援哪些雲端平台,證據未說明,使用前需自行在官方文件確認。

3 分鐘完成第一次嘗試

推薦的官方主路徑是本機容器快速啟動,全程不需要雲端帳號:

  1. 前提:本機安裝好 Docker 或 Podman 並啟動,CLI 需另行安裝(官方說明為 "Install the CLI separately",具體安裝指令請以官方 README 為準)。

  2. 安裝 agent 技能:在受支援的 agent 中執行官方指令:

    npx skills add openclaw/crabbox --skill crabbox

    官方還發布了一個 crabbox-quickstart 技能,可作為備選。

  3. 進入一個你信任的 Git 儲存庫(官方要求在可信儲存庫中操作)。

  4. 讓 agent(或在終端機)執行官方自檢指令:

    crabbox doctor --provider local-container

    成功訊號:doctor 通過本機容器環境檢查。

  5. 再跑一個低風險、唯讀的第一次任務,驗證整條鏈路:

    crabbox run --provider local-container -- uname -a

    成功訊號:Crabbox 會租用一台一次性容器盒子,把指令輸出串流回你的終端機,隨後釋放盒子。這個範例只執行 uname -a,不會更動你的檔案。

  6. 之後的核心工作流程是 crabbox run -- <cmd>:它會租用盒子、同步你的工作樹(包括未提交的變更)、執行指令並把輸出串流回終端機、回傳結束碼,然後釋放一次性盒子。注意:同步的是包括未提交變更在內的整個工作樹,首次跑真實測試指令前請確認你了解會被帶到盒子裡執行的內容。

使用案例

案例一:提交前在乾淨盒子裡跑測試套件。情境:你(或 agent)改完程式碼但不想汙染本機環境。讓 agent 執行 crabbox run -- pnpm test(把 pnpm test 換成你專案自己的測試指令)。可期待的結果:一台一次性盒子被租用,你的工作樹連同未提交變更被同步過去,測試輸出即時串流回終端機,結束後拿到真實結束碼,盒子被釋放。

案例二:驗證容器盒子環境。情境:第一次設定或懷疑環境有問題。讓 agent 先跑 crabbox doctor --provider local-container 做診斷,再跑 crabbox run --provider local-container -- uname -a 確認盒子能執行指令。可期待的結果:doctor 會回報本機容器環境是否就緒;run 會回傳盒子的系統資訊,證明租用—同步—執行—回收的完整鏈路可用。這兩個操作只做檢查和讀取系統資訊,是典型的低風險首次使用動作。

使用邊界

  • 副作用與確認點:每次 crabbox run 都會租用盒子並把你的工作樹(含未提交變更)同步到該盒子,再在其中執行你指定的指令——指令會在盒子裡真實執行,發起前請確認指令內容。本機容器路徑還會在你的機器上啟動容器;雲端盒子涉及的外部服務邊界,證據未說明。
  • 執行環境前提:本機容器快速路徑需要 Docker 或 Podman;SSH 工作流程需要本機 git、ssh、ssh-keygen、rsync、curl。
  • 用戶端前提:技能透過 npx skills add 安裝,適用於支援 agent skills 的 agent;具體哪些用戶端受支援,證據未逐一點名。
  • 尚未確認的關鍵資訊:雲端盒子的開通與帳號要求、crabbox doctor 或 run 是否會存取網路或讀寫哪些本機檔案、以及除文件所示指令外還有哪些子指令,官方證據均未說明,使用前請查閱官方 README。