skills.rest
JEROME-PRAKASH-L
JEROME-PRAKASH-LCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

crabbox

Orchestrates remote OpenClaw validation runs across AWS, Blacksmith Testbox, and SSH providers.

1|Updated Jun 9, 2026
Search Tags:#aws#ssh#ci#remote testing#e2e validation#crabbox#blacksmith testbox
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill crabbox-jerome-prakash-l
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: crabbox
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/.agents/skills/crabbox
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill crabbox-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running broad OpenClaw test gates, CI-parity checks, and end-to-end bug verification locally is slow and unreliable. This Skill routes remote validation through the Crabbox wrapper so tests execute on real Linux, macOS, Windows, or WSL2 environments with correct provider attribution. ## Core Features & Use Cases - Multi-provider remote execution: Run pnpm gates and E2E scenarios on brokered AWS Crabbox (cbx_... leases) or delegated Blacksmith Testbox (tbx_... ids), with static SSH targets for macOS and Windows hosts. - Observability and debugging: Use --timing-json, --preflight, --capture-on-fail, --full-resync, and phase markers to diagnose sync, hydration, and test failures. - Interactive proof: Drive desktop/WebVNC sessions and tmux-based CLI onboarding flows for human QA handoff. - Use Case: A maintainer fixes a Docker install bug, then runs one Crabbox E2E command from the user-facing entrypoint to prove the broken state before the fix and the passing state after, recording the Testbox id and redacted output. ## Quick Start Ask the assistant to run the changed-files test gate remotely via Crabbox with timing JSON enabled and report the actual provider and lease id.

Frequently Asked Questions about crabbox

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run OpenClaw tests remotely with Crabbox?▼

Run pnpm crabbox:run from the repo root with flags like --idle-timeout, --ttl, and --timing-json, passing the test command after --shell. Omitting --provider uses brokered AWS from .crabbox.yaml; add --provider blacksmith-testbox for delegated Testbox runs.

What is the difference between AWS Crabbox and Blacksmith Testbox?▼

Brokered AWS Crabbox is the direct provider with cbx_ lease ids and syncDelegated=false, while Blacksmith Testbox is a delegated provider with tbx_ ids where the workflow owns checkout and setup. Always report the actual provider and id in proof summaries.

Can Crabbox run tests on macOS or Windows hosts?▼

Yes, Crabbox supports static SSH targets for macOS and Windows, including WSL2 mode, using POSIX or PowerShell contracts. Native brokered Windows via Azure and AWS EC2 Mac Dedicated Hosts are also available with quota and coordinator support.

Why is my Crabbox sync stale and how do I fix it?▼

Stale remote workdirs happen when sync fingerprints drift or SSH times out before sync. Retry with --full-resync (alias --fresh-sync), which resets the remote workdir, skips the fingerprint fast path, and re-uploads the checkout from scratch.

How do I handle secrets safely in Crabbox runs?▼

Forward only the exact needed key using CRABBOX_ENV_ALLOW or --env-from-profile with --allow-env, never printing or syncing secret values. On Blacksmith Testbox, env forwarding is unsupported, so secrets must live in the Testbox workflow instead.

Related Skills

Explore More Software Engineering Skills→
openclawopenclaw
1.0k

crabbox

Automate remote OpenClaw validation on AWS and Blacksmith Testbox platforms.

Official
Advanced
app-vitalsapp-vitals
9

triage-dependabot-pr

Analyzes a Dependabot pull request and stages a local markdown review comment.

Official
Advanced
SocketDevSocketDev
125

greening-ci-local

Run GitHub Actions workflows locally in Docker and retry paused steps.

Official
Intermediate
openclawopenclaw
388.4k

crabbox

Route and execute remote validation runs across Crabbox, Testbox, AWS, and local-container providers.

Official
Advanced