技能包

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。