Crabbox 是 OpenClaw 项目用于远程验证的封装工具（wrapper），主要作用是把本地仓库检出同步到远程主机，并在远端执行测试、构建或端到端验证命令。它本身只承担传输与编排职责，真正执行任务的后端有两种：一是直接代理的 AWS Crabbox（provider=aws，租约 ID 形如 cbx_...），二是通过 Crabbox 委托的 Blacksmith Testbox（provider=blacksmith-testbox，ID 形如 tbx_...）。
用途与主要能力：Crabbox 面向需要远程 Linux 证明的场景，包括大范围测试、CI 对齐检查、密钥与托管服务、Docker/E2E/包安装通道、预热可复用机器、同步计时、日志与结果收集、缓存检查以及租约清理。它支持 Linux、macOS、Windows 和 WSL2 目标；Windows 可通过原生代理方式使用 AWS 开发者镜像（us-west-2，按需），macOS 需先确认协调器支持 EC2 Mac 主机生命周期且操作者具备配额与 IAM。也支持静态 SSH 目标（macOS、Windows 原生、Windows WSL2）。
使用方式：通常从仓库根目录执行，先检查 crabbox 可执行文件与 provider 配置，再通过 pnpm crabbox:run 或 node scripts/crabbox-wrapper.mjs run 提交命令。常用参数包括 --idle-timeout、--ttl、--timing-json、--provider、--shell、--preflight、--allow-env、--env-from-profile、--script/--script-stdin、--fresh-pr、--full-resync/--fresh-sync、--capture-stdout/--capture-stderr、--capture-on-fail、--keep-on-failure 等。输出 JSON 摘要包含 provider、leaseId、syncDelegated、commandPhases、commandMs/totalMs、exitCode 等字段。
适用场景：OpenClaw 维护者的大范围 pnpm 门禁（可用 Blacksmith Testbox 委托）、需要直接 AWS 行为的持久租约、Windows 专项证明、macOS 代理运行器（需配额与 IAM）、静态 SSH 主机验证，以及针对用户可见缺陷的最小 E2E 证明流程。
限制：委托 provider 不支持 --capture-、--download、--checksum、--force-sync-large、--sync-only、--script、--fresh-pr、--full-resync、--env-helper 等参数，因为同步或命令传输由后端负责；crabbox actions hydrate/register 目前仅限 Linux；静态 macOS/Windows 主机需可达且由操作者管理；macOS 代理需配额、IAM、协调器部署等前置条件。密钥应仅注入到单条命令的远程环境，不得打印、同步为仓库文件或留在远程历史与日志中。