Index of every page on this site: llms.txt
All skills
openclaw avatar

/crabbox

@0a5ba4b
by openclawopenclaw/agent-skills1.1k stars
126
Run it yourself

Crabbox/Testbox remote proof: portable provider routing, untrusted isolation, Linux/macOS/Windows/WSL2, live E2E, diagnostics, cleanup.

Use this Skill: https://skilld.dev/gh/openclaw/agent-skills/crabbox

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesproviders-and-desktop.md

≈730 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Provider and desktop recipes

Read only for selected provider or requested desktop/cross-OS proof. Routing and proof rules still apply: no provider escalation or waiting for capacity.

Direct AWS

"$CRABBOX" run --provider aws --timing-json --shell -- "<check-command>"
  • Stale sync: retry --full-resync once. Still bad: fresh lease.
  • One-shot should stop itself; failure/interruption: verify "$CRABBOX" list --provider aws.

Broker auth, not cloud keys:

"$CRABBOX" config show
"$CRABBOX" doctor
"$CRABBOX" whoami
"$CRABBOX" login --url <broker-url> --provider aws

Normal validation asks for AWS keys: usually wrong path.

Fresh PR / Container

  • --fresh-pr <owner/repo#123>: clean remote checkout. --apply-local-patch only for intentional local fixup. Direct providers only.

Local Docker only when resolved configuration selects it or user explicitly requests local-container lane:

"$CRABBOX" run \
  --provider local-container \
  --local-container-image <container-image> \
  --no-hydrate --fresh-pr <owner/repo#number> \
  --timing-json --shell -- \
  "<install-and-check-command>"
  • Report local-container; not AWS/Testbox. Keep --no-hydrate.
  • Host-mounted caches cannot cross filesystems: use repository-local dependency cache.

Desktop / Cross-OS

Static hosts:

"$CRABBOX" run --provider ssh --target macos \
  --static-host <macos-host> -- <check-command>
"$CRABBOX" run --provider ssh --target windows --windows-mode normal \
  --static-host <windows-host> -- pwsh -NoProfile -Command '<check-command>'
"$CRABBOX" run --provider ssh --target windows --windows-mode wsl2 \
  --static-host <windows-host> -- <check-command>
  • Windows/WSL2: prefer Azure when advertised/configured.
  • Native Windows: OpenSSH + PowerShell + Git + tar. Actions hydration Linux-only.

Brokered macOS: paid EC2 Mac. First quota/no-spend preflight. No silent substitution for Linux proof.

"$CRABBOX" admin hosts quota --provider aws --target macos \
  --region eu-west-1 --type mac2.metal --json
"$CRABBOX" admin hosts allocate --provider aws --target macos \
  --region eu-west-1 --type mac2.metal --dry-run --json

Human desktop: prefer WebVNC when resolved provider supports it. Never change providers only to gain desktop support.

"$CRABBOX" warmup --desktop --browser --keep
"$CRABBOX" desktop launch --id <id> \
  --browser --url https://example.com --webvnc --open --take-control
"$CRABBOX" desktop doctor --id <id>
"$CRABBOX" webvnc status --id <id>
"$CRABBOX" artifacts collect --id <id> --all --output artifacts/<slug>

Before handoff: prove CLI/app from neutral ~:

"$CRABBOX" run --id <id> --shell -- \
  "cd ~ && command -v <command> && <command> --version"
  • Visible desktop alone proves nothing. Keep browser windowed unless capture task.
  • Never commit proof assets to product repo.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts15d3 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    Crabbox is a remote execution and CI/E2E testing tool. The skill provides instructions for managing remote providers like AWS and Testbox while implementing rigorous security measures for isolating untrusted code and protecting sensitive credentials.

  • Socket15d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

Signed by skilld at 0a5ba4b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 weeks ago

README badge

README badge for openclaw/agent-skills/crabbox