From f93b602842f88195f76999aec687fb5f4653d1b2 Mon Sep 17 00:00:00 2001 From: Vladislav Sokolovskii Date: Fri, 26 Jun 2026 13:58:05 +0200 Subject: [PATCH 1/3] Add Crabbox E2B use case docs --- docs.json | 1 + docs/use-cases/crabbox.mdx | 73 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 74 insertions(+) create mode 100644 docs/use-cases/crabbox.mdx diff --git a/docs.json b/docs.json index e5130511..73fb6527 100644 --- a/docs.json +++ b/docs.json @@ -50,6 +50,7 @@ "pages": [ "docs/use-cases/coding-agents", "docs/use-cases/computer-use", + "docs/use-cases/crabbox", "docs/use-cases/ci-cd", "docs/use-cases/remote-browser" ] diff --git a/docs/use-cases/crabbox.mdx b/docs/use-cases/crabbox.mdx new file mode 100644 index 00000000..699c596b --- /dev/null +++ b/docs/use-cases/crabbox.mdx @@ -0,0 +1,73 @@ +--- +title: "Crabbox" +description: "Run Crabbox test and execution workflows on E2B sandboxes." +icon: "terminal" +--- + +[Crabbox](https://github.com/openclaw/crabbox) is a remote software testing and execution control plane for maintainers and AI agents. Use its E2B provider when you want Crabbox to create an E2B Linux sandbox, sync your working tree, run a command, stream output, and clean up from one CLI command. + +## Install + +Install Crabbox locally. + +```bash +brew install openclaw/tap/crabbox +crabbox --version +``` + +## Configure E2B + +Export your E2B API key before running Crabbox. + +```bash +export E2B_API_KEY=e2b_... +``` + +You can select E2B per command with `--provider e2b`, or set it in a repo-level Crabbox config. + +```yaml .crabbox.yaml +provider: e2b +target: linux +e2b: + template: base + workdir: crabbox +``` + +`template` is the E2B template to create. `workdir` is the directory where Crabbox syncs and runs your project inside the sandbox. + +## Run tests + +Run a command in a fresh E2B sandbox. + +```bash +crabbox run --provider e2b -- echo crabbox-e2b-ok +``` + +Use an existing warm sandbox for repeated runs. + +```bash +crabbox warmup --provider e2b --e2b-template base +lease="" +crabbox run --provider e2b --id "$lease" -- echo crabbox-e2b-ok +crabbox status --provider e2b --id "$lease" --wait +crabbox stop --provider e2b "$lease" +``` + +Run in a custom E2B workdir. + +```bash +crabbox run --provider e2b --e2b-workdir repo -- echo crabbox-e2b-ok +``` + +## How it works + +With `provider: e2b`, Crabbox uses E2B sandbox lifecycle, file upload, and process APIs instead of SSH. Crabbox owns local config, sync manifests, command orchestration, output streaming, and normalized `list` / `status` behavior. E2B owns the sandbox runtime and command transport. + +## Limitations + +- E2B is a Linux delegated-run provider for Crabbox. +- Crabbox SSH commands such as `ssh`, `vnc`, `code`, and SSH-based Actions hydration are not available with `provider: e2b`. +- `--class` and `--type` are rejected because sandbox resources come from the selected E2B template. +- `--e2b-template`, `--e2b-workdir`, `--e2b-user`, `--e2b-api-url`, and `--e2b-domain` override matching config values. + +For the full Crabbox command and provider reference, see the [Crabbox repository](https://github.com/openclaw/crabbox). From 0563a1071a060e22261bb3a9adc9fab992415566 Mon Sep 17 00:00:00 2001 From: Vladislav Sokolovskii Date: Fri, 26 Jun 2026 14:01:45 +0200 Subject: [PATCH 2/3] Add Crabbox logo icon --- docs/use-cases/crabbox.mdx | 2 +- images/icons/crabbox.svg | 8 ++++++++ 2 files changed, 9 insertions(+), 1 deletion(-) create mode 100644 images/icons/crabbox.svg diff --git a/docs/use-cases/crabbox.mdx b/docs/use-cases/crabbox.mdx index 699c596b..72a866f8 100644 --- a/docs/use-cases/crabbox.mdx +++ b/docs/use-cases/crabbox.mdx @@ -1,7 +1,7 @@ --- title: "Crabbox" description: "Run Crabbox test and execution workflows on E2B sandboxes." -icon: "terminal" +icon: "/images/icons/crabbox.svg" --- [Crabbox](https://github.com/openclaw/crabbox) is a remote software testing and execution control plane for maintainers and AI agents. Use its E2B provider when you want Crabbox to create an E2B Linux sandbox, sync your working tree, run a command, stream output, and clean up from one CLI command. diff --git a/images/icons/crabbox.svg b/images/icons/crabbox.svg new file mode 100644 index 00000000..c34a2c3f --- /dev/null +++ b/images/icons/crabbox.svg @@ -0,0 +1,8 @@ + + + + + + + + From 3aeee3db5761e786f04086c2dfef4fd3905ccd1d Mon Sep 17 00:00:00 2001 From: Vladislav Sokolovskii Date: Fri, 26 Jun 2026 14:17:02 +0200 Subject: [PATCH 3/3] Refine Crabbox docs label and icon --- docs/use-cases/crabbox.mdx | 2 +- images/icons/crabbox.svg | 12 +++++++++--- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/use-cases/crabbox.mdx b/docs/use-cases/crabbox.mdx index 72a866f8..7078f152 100644 --- a/docs/use-cases/crabbox.mdx +++ b/docs/use-cases/crabbox.mdx @@ -1,5 +1,5 @@ --- -title: "Crabbox" +title: "Crabbox with E2B" description: "Run Crabbox test and execution workflows on E2B sandboxes." icon: "/images/icons/crabbox.svg" --- diff --git a/images/icons/crabbox.svg b/images/icons/crabbox.svg index c34a2c3f..c14971ef 100644 --- a/images/icons/crabbox.svg +++ b/images/icons/crabbox.svg @@ -1,8 +1,14 @@ - + - + - +