openclaw/crabbox
ON-DEMAND COMPUTERS FOR CODING AGENTS
A tool to lease temporary machines (cloud, local containers, or your own) to run agent tests and builds while the developer edits code locally. Synchronizes the working directory with uncommitted changes, streams output, and returns the exit code.
// KEY FEATURES
- Lease boxes in cloud, local containers, or on your own machines
- Sync uncommitted changes without commits or pushes
- Support Linux, macOS, Windows, and WSL2 from a single CLI
- Optional coordinator for teams: spend caps, usage tracking, lease cleanup
// DEEP DIVE: HOW IT WORKS
Crabbox leases 'boxes' — temporary machines in the cloud (AWS, GCP, Hetzner, etc.), local Docker/Podman containers, or physical hosts via SSH. The CLI syncs the working tree via rsync (including unsaved edits), runs the given command, streams stdout/stderr to the terminal, and returns the exit code, then tears down the lease. A warmup mode exists to preheat a box and reuse dependencies across runs.
Differs by focusing on agents: the optional coordinator centralizes secrets, tracks spend, enforces caps, and cleans stale leases. Supports graphical access via VNC/WebVNC and browser VS Code for inspection. Not tied to a specific CI — just provides a computer and execution evidence; the agent or harness decides what the result means.
Requires Docker/Podman for the local provider, plus git, ssh, rsync in PATH. Cloud providers need corresponding credentials and prepared images. The coordinator is a separate service, optional for solo use. Windows supported via WSL2 or native. First image pull and bootstrap take time.
// USE CASES
Best for: developers and teams running AI agent tests in parallel
- Run tests of multiple agents in parallel in isolated cloud boxes
- Verify builds on Linux, macOS, and Windows without leaving the local machine
- Give the agent access to a browser and desktop via VNC for UI tests
// QUICK START
brew install openclaw/tap/crabbox
crabbox --version
crabbox doctor --provider local-container
crabbox run --provider local-container -- uname -a
crabbox warmup --provider local-containerCommands are taken from the repository README — check the current version on GitHub before running.
New repositories every 30 minutes
REDDYX AI scans GitHub 24/7 and ships the best AI/ML/Web3 projects to Telegram.
Join on Telegram