Crabbox 是面向 OpenClaw 的远程验证包装与编排层,用于在 Linux、macOS、Windows、WSL2 上执行广泛测试、CI 对齐检查、密钥与托管服务验证、Docker/E2E/包测试、预热可复用盒子、同步计时、日志与结果检查、缓存检查及租约清理。
用途与后端:实际后端可为代理 AWS Crabbox(provider=aws,租约 id 形如 cbx_...,syncDelegated=false)或通过 Crabbox 委派的 Blacksmith Testbox(provider=blacksmith-testbox,id 形如 tbx_...,syncDelegated=true)。OpenClaw 维护者广泛 pnpm 门禁适合用 Testbox-through-Crabbox;需要直接 AWS 行为、持久直连租约、--fresh-pr、--full-resync、环境转发、捕获下载或提供商对比时用代理 AWS 路径。
使用方式:从仓库根目录运行,Crabbox 同步当前检出。先检查包装器与提供商,如 command -v crabbox、../crabbox/bin/crabbox --version、pnpm crabbox:run -- --help。.crabbox.yaml 定义直连默认值,省略 --provider 默认代理 AWS。广泛维护者 pnpm 门禁优先用 --provider blacksmith-testbox。始终报告实际 provider 和 id。
主要能力与标志:--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 输出计时。委派提供商不支持 --capture-、--download、--checksum、--force-sync-large、--sync-only、--script、--fresh-pr、--full-resync、--env-helper。
限制:live 证明需可达的运营商管理 SSH 主机;macOS AWS 需 EC2 Mac 专用主机配额与 IAM;crabbox actions hydrate/register 目前仅 Linux。本地 shell 继承的 OPENCLAW_LOCAL_CHECK_MODE=throttled 不构成把广泛门禁移到本地的授权;仅在用户明确要求本地证明时使用。