diff --git a/.agents/skills/crabbox/SKILL.md b/.agents/skills/crabbox/SKILL.md index b40a3bc0089..fe2419ecc8c 100644 --- a/.agents/skills/crabbox/SKILL.md +++ b/.agents/skills/crabbox/SKILL.md @@ -21,7 +21,7 @@ runner class, reusable warm state, or a Blacksmith alternative. `../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`. + `printf '%s' "$CRABBOX_COORDINATOR_TOKEN" | crabbox login --url https://crabbox.openclaw.ai --provider aws --token-stdin`. - On macOS the user config is `~/Library/Application Support/crabbox/config.yaml`; it must include `broker.url`, `broker.token`, and usually `provider: aws`. @@ -31,6 +31,7 @@ AWS/owned-capacity flow for `pnpm` tests: ```sh pnpm crabbox:warmup -- --idle-timeout 90m +pnpm crabbox:warmup -- --provider aws --class beast --market on-demand --idle-timeout 90m 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" ``` @@ -63,6 +64,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. +Use `--market spot|on-demand` on AWS warmup or one-shot run when testing quota +or capacity behavior without changing `.crabbox.yaml`. ## Hydration Boundary @@ -79,3 +82,6 @@ workflow and generic lease/sync behavior in Crabbox. Crabbox has coordinator-owned idle expiry and local lease claims, so OpenClaw does not need a custom ledger. Default idle timeout is 30 minutes unless config or flags set a different value. Still stop boxes you created when done. +If `crabbox list` prints `orphan=no-active-lease`, treat it as an operator +review hint; do not delete `keep=true` machines without checking provider and +coordinator state.