Crabbox 是 OpenClaw 用于远程验证的传输与编排封装,支持 Linux、macOS、Windows 与 WSL2,并包含委派式 Blacksmith Testbox 证明。后端可为代理式 AWS Crabbox(provider=aws,租约号如 cbx_...,syncDelegated=false),或经 Crabbox 使用的 Blacksmith Testbox(provider=blacksmith-testbox,编号如 tbx_...,syncDelegated=true)。
用途与能力:需要远程 Linux 证明时使用,覆盖广泛测试、CI 一致性校验、密钥、托管服务、Docker/E2E/包通道、可预热复用盒子、同步计时、日志与结果、缓存检查以及租约清理。OpenClaw 维护者的大型 pnpm 门禁可优先走 Blacksmith Testbox 路径,须报告为 Testbox-through-Crabbox 并给出 tbx_ 编号与 Actions 运行,不得称其为 AWS Crabbox。
使用方式:从仓库根目录运行,Crabbox 同步会镜像当前检出。常用命令包括 command -v crabbox、../crabbox/bin/crabbox --version、pnpm crabbox:run -- --help、../crabbox/bin/crabbox desktop launch --help、../crabbox/bin/crabbox webvnc --help。省略 --provider 默认走代理式 AWS。静态 SSH 目标可用 crabbox run --provider ssh --target macos --static-host mac-studio.local -- xcodebuild test 等形式。
适用场景与限制:直接 AWS 后端适合需要直接 AWS 语义、持久直接供应商租约、--fresh-pr、--full-resync、环境转发、捕获/下载支持的场景。委派供应商不支持 --capture-、--download、--checksum、--force-sync-large、--sync-only、--script、--fresh-pr、--full-resync、--env-helper。macOS AWS 需确认协调器支持 EC2 Mac 生命周期且操作者具备专用主机配额与 IAM。本地定向测试优先,广泛门禁放远程;不得把继承的 OPENCLAW_LOCAL_CHECK_MODE=throttled 当作本地运行广泛检查的许可。始终报告实际供应商与编号。密钥须用配置的密钥工作流按需注入,不打印、不写仓库文件、不留存在远程历史或日志中。其余细节暂未提供。