crabbox
Use Crabbox for OpenClaw remote Linux validation, warmed reusable boxes, GitHub Actions hydration, sync timing, logs, results, caches, and lease cleanup.
Best for OpenClaw developmentWorks with GitHub
⌘source
- author
@openclaw- language
- TypeScript
★367kstars
76kforks
May 1, 2026
✦overview.md
Key Features
- ·Remote Linux validation on owned capacity
- ·Reusable warmed boxes with idle timeout
- ·GitHub Actions hydration
- ·Broad OpenClaw gates
- ·Blacksmith alternative
Use Cases
- →Validating OpenClaw changes on remote Linux runners before merging
- →Reusing warm boxes for faster CI iteration
- →Running broad proof instead of local targeted tests
- →Using owned AWS/Hetzner capacity for CI
Best for
- ✓OpenClaw development
- ✓Remote Linux CI
- ✓Large runner classes
Not ideal for
- !Local tight edit loops
- !Blacksmith-specific tasks
FAQs
name
crabbox
description
Use Crabbox for OpenClaw remote Linux validation, warmed reusable boxes, GitHub Actions hydration, sync timing, logs, results, caches, and lease cleanup.
Crabbox
Use Crabbox when OpenClaw needs remote Linux proof on owned capacity, a large runner class, reusable warm state, or a Blacksmith alternative.
Before Running
- Run from the repo root. Crabbox sync mirrors the current checkout.
- Prefer local targeted tests for tight edit loops.
- Prefer Blacksmith Testbox when the task explicitly asks for Blacksmith or a Blacksmith-specific CI comparison.
- Use Crabbox for broad OpenClaw gates when owned AWS/Hetzner capacity is the right remote lane.
- Check
.crabbox.yamlfor repo defaults before adding flags. - 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; it must includebroker.url,broker.token, and usuallyprovider: aws.
OpenClaw Flow
Warm a reusable box:
pnpm crabbox:warmup -- --idle-timeout 90m
Hydrate it through the repository workflow:
pnpm crabbox:hydrate -- --id <cbx_id-or-slug>
Run broad proof:
$install
1-click copynpx skills add openclaw/openclaw --skill crabboxSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.