Crabbox 是 OpenClaw 的远程验证包装器与传输编排层，用于在远端执行宽泛测试、CI 对等检查、密钥与托管服务验证、Docker/E2E/打包流水线，以及预热可复用机器、同步计时、日志与结果查看、缓存检查和租约清理。后端可为两类：直连 AWS Crabbox（provider=aws，租约 ID 形如 cbx_...，syncDelegated=false）或经 Crabbox 委派的 Blacksmith Testbox（provider=blacksmith-testbox，ID 形如 tbx_...，syncDelegated=true）。报告时必须写明实际 provider 和 ID：cbx_ 为 AWS Crabbox，tbx_ 为 Testbox-through-Crabbox。
使用方式：从仓库根目录运行，同步会镜像当前检出。先检查包装器与 provider，例如 command -v crabbox、../crabbox/bin/crabbox --version、pnpm crabbox:run -- --help、../crabbox/bin/crabbox desktop launch --help 等。OpenClaw 脚本优先使用 ../crabbox/bin/crabbox。省略 --provider 默认走 brokered AWS。宽泛的维护者 pnpm 门禁优先用仓库包装器加 --provider blacksmith-testbox。支持静态 SSH 目标（provider ssh），macOS/WSL2 走 POSIX SSH/bash/Git/rsync/tar 契约，原生 Windows 用 OpenSSH/PowerShell/Git/tar。direct 提供者支持 --preflight、CRABBOX_ENV_ALLOW、--env-from-profile、--script、--fresh-pr、--full-resync、--capture-stdout/stderr、--capture-on-fail、--keep-on-failure、--timing-json 等；委派 provider 不接受 --capture-、--script、--fresh-pr、--full-resync、--env-helper 等。
限制：actions hydrate/register 目前仅支持 Linux，静态 macOS/Windows 需用普通 crabbox run 循环；实时验证需要可访问的受管 SSH 主机，否则只能做配置/标志测试与 Go 测试套件。macOS AWS 需确认协调器支持 EC2 Mac 生命周期并具备配额与 IAM。密钥应仅按需注入单个命令环境，不得打印或同步为仓库文件。预热租约疑似过期时先试 --full-resync。不要把继承的 shell 环境当作操作者意图；仅当用户在当前任务明确要求本地证明时才用 OPENCLAW_LOCAL_CHECK_MODE。文档未提供收费、价格与具体平台支持细节。