diff --git a/.agents/skills/crabbox/SKILL.md b/.agents/skills/crabbox/SKILL.md index 78d6d23c0b9..b40a3bc0089 100644 --- a/.agents/skills/crabbox/SKILL.md +++ b/.agents/skills/crabbox/SKILL.md @@ -17,6 +17,9 @@ runner class, reusable warm state, or a Blacksmith alternative. - Use Crabbox for broad OpenClaw gates when owned AWS/Hetzner capacity is the right remote lane. - Check `.crabbox.yaml` for repo defaults before adding flags. +- Sanity-check the selected binary before remote work. OpenClaw scripts prefer + `../crabbox/bin/crabbox` when present; the user PATH shim can be stale: + `command -v crabbox; ../crabbox/bin/crabbox --version; ../crabbox/bin/crabbox --help | sed -n '1,90p'`. - Install with `brew install openclaw/tap/crabbox`; auth is required before use: `printf '%s' "$CRABBOX_COORDINATOR_TOKEN" | crabbox login --url https://crabbox-coordinator.steipete.workers.dev --provider aws --token-stdin`. - On macOS the user config is `~/Library/Application Support/crabbox/config.yaml`; @@ -24,23 +27,18 @@ runner class, reusable warm state, or a Blacksmith alternative. ## OpenClaw Flow -Warm a reusable box: +AWS/owned-capacity flow for `pnpm` tests: ```sh pnpm crabbox:warmup -- --idle-timeout 90m -``` - -Hydrate it through the repository workflow: - -```sh pnpm crabbox:hydrate -- --id +pnpm crabbox:run -- --id --timing-json --shell -- "env NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_TEST_PROJECTS_PARALLEL=6 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm test:changed" ``` -Run broad proof: +Blacksmith-backed Crabbox flow can delegate setup to the Testbox workflow: ```sh -pnpm crabbox:run -- --id --shell "OPENCLAW_TESTBOX=1 pnpm check:changed" -pnpm crabbox:run -- --id --shell "corepack enable && pnpm install --frozen-lockfile && pnpm test" +pnpm crabbox:run -- --provider blacksmith-testbox --blacksmith-org openclaw --blacksmith-workflow .github/workflows/ci-check-testbox.yml --blacksmith-job check --blacksmith-ref main --idle-timeout 90m --timing-json --shell -- "env NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_TEST_PROJECTS_PARALLEL=6 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm test:changed" ``` Stop boxes you created before handoff: @@ -63,6 +61,8 @@ crabbox ssh --id ``` Use `--debug` on `run` when measuring sync timing. +Use `--timing-json` on warmup, hydrate, and run when comparing AWS and +blacksmith-testbox timings. ## Hydration Boundary