Crabbox 是 OpenClaw 的远程验证封装工具，充当传输与编排层，实际后端可以是直连 AWS Crabbox（provider=aws，租约 ID 如 cbx_...，syncDelegated=false）或通过 Crabbox 委托 Blacksmith Testbox（provider=blacksmith-testbox，ID 如 tbx_...，syncDelegated=true）。使用时需从仓库根目录运行，Crabbox 会镜像当前检出内容。
主要用途包括：远程 Linux 证明、CI 一致性检查、密钥与托管服务测试、Docker/E2E/打包通道、预热可复用盒子、同步计时、日志与结果查看、缓存检查以及租约清理。支持静态 SSH 目标（macOS、Windows、WSL2），原生 Windows 目标使用 OpenSSH、PowerShell、Git 和 tar。提供 --preflight 诊断、环境变量白名单转发（CRABBOX_ENV_ALLOW）、从 profile 加载环境变量、脚本上传执行、--fresh-pr 拉取 PR 检出、--full-resync 重置远程工作区、--capture-stdout/--capture-stderr 捕获输出、--capture-on-fail 失败时下载测试产物、--keep-on-failure 保留失败租约以及 --timing-json 计时汇总等功能。
使用方式上，可通过 pnpm crabbox:run 或 node scripts/crabbox-wrapper.mjs 调用，指定 provider、target、超时、TTL 等参数。对于 OpenClaw 维护者的大范围 pnpm 门禁，推荐使用 --provider blacksmith-testbox。macOS 目标需确认 coordinator 支持 EC2 Mac 主机生命周期，且操作者具备 AWS EC2 Mac Dedicated Host 配额和 IAM 权限，可先运行不产生费用的预检命令。
限制方面：部分选项（如 --capture-、--download、--checksum、--script、--fresh-pr、--full-resync、--env-helper 等）在委托 provider 上不被支持；crabbox actions hydrate/register 目前仅支持 Linux；直接原生 Windows 运行支持 --script*、--env-from-profile、--preflight 和 PowerShell --shell；静态 macOS 和 Windows 主机需使用普通 crabbox run 循环。实时证明需要可访问的、由操作者管理的 SSH 主机，否则只能通过帮助输出、配置/标志测试和 Go 测试套件验证。未提供具体收费、价格或平台范围信息。