用途：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，委派运行不能称作 AWS Crabbox。
主要能力：从仓库根目录运行，同步当前检出；支持 --preflight 诊断、CRABBOX_ENV_ALLOW 与 --env-from-profile/--allow-env 环境转发、--env-helper 持久化、--script/--script-stdin 上传脚本、--fresh-pr 新建 PR 检出、--full-resync 重置远端工作目录、--capture-stdout/--capture-stderr 与 --capture-on-fail 采集、--keep-on-failure 保留失败租约、--timing-json 输出计时与 commandPhases。静态 SSH 目标支持 macOS、Windows 原生与 WSL2；native Windows 用 OpenSSH/PowerShell/Git/tar。
使用方式：先检查 command -v crabbox、../crabbox/bin/crabbox --version 与 --help；OpenClaw 脚本优先 ../crabbox/bin/crabbox。广域维护者 pnpm 门禁可经 scripts/crabbox-wrapper.mjs 使用 --provider blacksmith-testbox。查看测试箱用 blacksmith testbox list --all 与 blacksmith testbox status <tbx_id>。清理用 ../crabbox/bin/crabbox list --provider aws 校验。
适用场景：直连 AWS 适合需要直连语义、持久直连租约、--fresh-pr、--full-resync、环境转发、采集下载或 provider 对比的任务；Testbox 适合维护者广域/重型 pnpm 门禁与已备 CI 环境；非 Linux 目标仅在需要现有 macOS/Windows 主机时使用。
限制：actions hydrate/register 目前仅限 Linux，静态 macOS/Windows 用普通 run 循环；delegated provider 不支持 --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 当作许可把广域检查移到本地。