用途:Crabbox 是 OpenClaw 的传输与编排层,用于远程 Linux 验证,覆盖广泛测试、CI 一致性检查、密钥、托管服务、Docker/E2E/打包通道、预热可复用机器、同步计时、日志结果、缓存检查与租约清理。也可用于 macOS、Windows 与 WSL2 目标,但仅在任务需要非 Linux 主机时使用。
后端与报告:后端可为直连 AWS Crabbox(provider=aws,租约 ID 形如 cbx_,syncDelegated=false)或经 Crabbox 委托的 Blacksmith Testbox(provider=blacksmith-testbox,ID 形如 tbx_,syncDelegated=true)。必须如实报告实际 provider 和 ID,不得把 Testbox 运行描述为 AWS Crabbox。
使用方式:应从仓库根目录运行,先检查封装与 provider,例如 command -v crabbox、../crabbox/bin/crabbox --version、pnpm crabbox:run -- --help。OpenClaw 脚本优先使用 ../crabbox/bin/crabbox。省略 --provider 时默认为 brokered AWS。
主要能力:支持静态 SSH 目标、--preflight 诊断、环境变量白名单转发(CRABBOX_ENV_ALLOW、--env-from-profile、--allow-env)、--script/--script-stdin 脚本上传执行、--fresh-pr 拉取 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,也不支持环境变量转发。actions hydrate/register 目前仅支持 Linux。macOS 需确认协调器支持 EC2 Mac 主机生命周期及配额与 IAM。密钥应通过配置的密钥流程注入,不得打印、同步为仓库文件或留在远端历史与日志中;无安全注入路径时应说明 live provider 认证受阻,而非使用假密钥。