broker:
  url: <broker-url>
  token: <token>
provider: aws

Pick The Proof

• Small/narrow tests, docs link checks, formatting, and focused unit tests: run locally first.
• Broad suites, package-heavy checks, Docker/E2E/live-provider proof, or cross-OS behavior: run on Crabbox.
• If a local command starts fanning out or bogs down the Mac, stop it and move the proof remote.
• Before shipping a user-visible behavior fix, prefer one remote command that starts from the user-facing entrypoint.
• If remote proof is blocked, say exactly which capability is missing: auth, capacity, provider support, target OS, hydration, or secret access.

OpenClaw Provider Choice

For OpenClaw/OpenClawd validation, prefer Blacksmith Testbox first when the workflow already gives the needed setup and the delegated command path is enough:

crabbox run --provider blacksmith-testbox --timing-json -- pnpm test

If Blacksmith is queued, unavailable, unauthenticated, or lacks the SSH-backed feature needed for the proof, rerun the same command shape on AWS:

crabbox run --provider aws --timing-json -- pnpm test

Actions setup remains repo-owned in both paths. Blacksmith owns Testbox workflow hydration and command transport. AWS uses Crabbox SSH sync/run and Actions hydration for the persistent workspace. This is operator choice, not automatic CLI fallback.

Common Flow

One-shot command:

crabbox run --timing-json --preflight -- pnpm test

Warm a reusable box:

crabbox warmup --idle-timeout 90m
crabbox warmup --provider aws --class beast --market on-demand --idle-timeout 90m
crabbox warmup --provider aws --os ubuntu:26.04 --desktop --browser --desktop-env wayland
crabbox warmup --provider aws --os ubuntu:26.04 --desktop --browser --desktop-env gnome

ubuntu:26.04 is the preferred portable Linux OS selector where the provider catalog supports it. Use --os ubuntu:24.04 only when a test must stay on the previous LTS. Explicit provider image flags still win over --os.

Repos with actions.workflow hydrate automatically during crabbox run. Use manual hydration when you want to prepare a reused lease before running commands:

crabbox actions hydrate --id <cbx_id-or-slug>

Use crabbox actions hydrate --github-runner --id <cbx_id-or-slug> when the workflow needs full GitHub Actions semantics, repository secrets, OIDC, service containers, or unsupported uses: steps.

Run commands:

crabbox run --id <cbx_id-or-slug> -- pnpm test:changed
crabbox run --id <cbx_id-or-slug> --full-resync -- pnpm test:changed
crabbox run --id <cbx_id-or-slug> --shell "corepack enable && pnpm install --frozen-lockfile && pnpm test"

For package-manager commands on raw AWS/Hetzner boxes, rely on configured

…

openclaw-test-heap-leaks

帮助定位 OpenClaw 测试中的内存增长、堆泄漏与 OOM 根因

telegram-crabbox-e2e-proof

在Crabbox上复现并录制真实Telegram交互以验证行为证据