用途:Crabbox 是 OpenClaw 的远程验证传输/编排层,用于在远程 Linux 上运行范围较广的测试、CI 一致性检查、机密与托管服务测试、Docker/E2E/打包通道、预热可复用机器、同步计时、日志与结果收集、缓存检查和租约清理。它本身不是后端,实际后端可以是两种:经代理的 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 的 Blacksmith Testbox。
主要能力与用法:从仓库根目录运行,Crabbox 同步当前检出内容。先检查封装与 provider,例如 command -v crabbox、../crabbox/bin/crabbox --version、pnpm crabbox:run -- --help 等;存在 ../crabbox/bin/crabbox 时优先使用它,用户 PATH 中的 shim 可能过期。省略 --provider 时默认走代理 AWS;仓库 .crabbox.yaml 提供默认配置。广范围 OpenClaw 维护者 pnpm 门禁用 --provider blacksmith-testbox 或仓库 Testbox 辅助工具。
可观测性标志:--preflight 打印运行上下文与工具探测;CRABBOX_ENV_ALLOW 仅转发列出的本地环境变量;--env-from-profile 配合 --allow-env 从本地 profile 加载允许的环境变量;--script/--script-stdin 上传并执行脚本;--fresh-pr 创建 PR 的全新远程检出;--full-resync/--fresh-sync 重置过期工作目录;--capture-stdout/--capture-stderr、--capture-on-fail 捕获输出与失败产物;--keep-on-failure 保留失败租约;--timing-json 输出机器可读计时。委派的 Blacksmith Testbox 不支持 --capture-、--download、--checksum、--force-sync-large、--sync-only、--script、--fresh-pr、--full-resync、--env-helper 等,因为 provider 自己负责同步或命令传输。
平台与限制:原生代理 Windows 可用于 Windows 专属证明;macOS 需确认协调器支持 EC2 Mac 生命周期/镜像路由并有配额与 IAM。Crabbox 支持静态 SSH 目标(如 --provider ssh --target macos --static-host ...)。crabbox actions hydrate/register 目前仅限 Linux。实况 provider 需要可达的、由操作者管理的 SSH 主机;没有主机时只能用帮助、配置/标志测试和 Go 测试套件验证。文档未提供的收费、价格与效果信息暂未提供。