Crabbox 是 OpenClaw 使用的远程验证包装器。按资料描述，它本身是传输/编排层，实际执行后端可以是两种：一是经代理的 AWS Crabbox（provider=aws，租约 ID 形如 cbx_...，syncDelegated=false）；二是通过 Crabbox 调用的 Blacksmith Testbox（provider=blacksmith-testbox，ID 形如 tbx_...，syncDelegated=true）。使用时需注意如实报告实际 provider 与 ID：cbx_ 表示 AWS Crabbox，tbx_ 表示经 Crabbox 的 Testbox，不应把 Testbox 运行描述为 AWS Crabbox。
主要用途与适用场景：远程 Linux 上的广度验证、CI 一致性检查、密钥与托管服务测试、Docker/E2E/打包流水线、预热可复用实例、同步计时、日志与结果采集、缓存检查以及租约清理。当任务需要 CI 就绪环境、重型 pnpm 门禁或 OpenClaw 维护者 Testbox 证明时，可选用 blacksmith-testbox；当任务需要直接的 AWS Crabbox 语义、持久化直接 provider 租约、--fresh-pr、--full-resync、环境转发、捕获/下载支持或 provider 对比时，使用仓库 .crabbox.yaml 中配置的 AWS 路径。macOS 与 Windows 目标仅在任务确实需要非 Linux 主机时使用；原生 Windows 可按需使用 us-west-2 的 AWS 开发者镜像，但广度 Linux 门禁应留在 Linux/Testbox 上，除非缺陷是 Windows 特有。
使用方式（均来自资料原文）：先在仓库根目录确认包装器与 provider，例如 command -v crabbox、../crabbox/bin/crabbox --version、pnpm crabbox:run -- --help 等；OpenClaw 脚本优先使用 ../crabbox/bin/crabbox。Windows 预热示例为 ../crabbox/bin/crabbox warmup --provider aws --target windows --windows-mode normal --region us-west-2 --market on-demand --timing-json。AWS 变更门禁与全量套件通过 pnpm crabbox:run 传入 --idle-timeout 90m、--ttl 240m、--timing-json、--shell 及相应 pnpm test 命令。Testbox 通过 node scripts/crabbox-wrapper.mjs run --provider blacksmith-testbox 并指定 blacksmith-org、workflow、job、ref 等参数。静态 SSH 目标可使用 --provider ssh --target macos/windows，Windows 支持 normal 与 wsl2 模式。观测参数包括 --preflight、CRABBOX_ENV_ALLOW、--env-from-profile、--env-helper、--script/--script-stdin、--fresh-pr、--full-resync、--capture-stdout/--capture-stderr、--capture-on-fail、--keep-on-failure、--timing-json 等。
限制与注意事项：委派的 provider 不支持 --capture-、--download、--checksum、--force-sync-large、--sync-only、--script、--fresh-pr、--full-resync、--env-helper；--keep-on-failure 在委派一次性任务中可用。crabbox actions hydrate/register 目前仅限 Linux；静态 macOS/Windows 主机使用普通 crabbox run 循环。实时证明需要可达且由操作者管理的 SSH 主机。密钥应按密钥安全工作流仅注入所需环境变量，不打印、不作为仓库文件同步、不留在远程 shell 历史或日志。对于实时 provider 认证缺失的情况，应说明被阻断而非使用假密钥。macOS brokered 运行需确认协调器支持 EC2 Mac 主机生命周期/镜像路由，并具备 AWS EC2 Mac Dedicated Host 配额与 IAM。资料未提供具体收费、价格、平台版本或效果数据。