### Build and Run Node.js Coordinator

Source: https://github.com/openclaw/crabbox/blob/main/docs/operations.md

Installs dependencies, runs checks, builds, and starts the Node.js coordinator with PostgreSQL configuration.

```sh
npm ci --prefix worker
npm run format:check --prefix worker
npm run lint --prefix worker
npm run check:node --prefix worker
npm test --prefix worker
npm run build:node --prefix worker

DATABASE_URL='postgresql://crabbox:password@db.example.com/crabbox?sslmode=verify-full&sslrootcert=/run/secrets/postgres-ca.pem' \
CRABBOX_PUBLIC_URL=https://broker.example.com \
npm run start:node --prefix worker
```

--------------------------------

### Artifact Backend Configuration

Source: https://github.com/openclaw/crabbox/blob/main/docs/operations.md

Configure the artifact backend using environment variables. This example shows a typical R2-compatible setup.

```text
CRABBOX_ARTIFACTS_BACKEND=r2
CRABBOX_ARTIFACTS_BUCKET=my-crabbox-artifacts
CRABBOX_ARTIFACTS_PREFIX=crabbox-artifacts
CRABBOX_ARTIFACTS_BASE_URL=https://artifacts.example.com
CRABBOX_ARTIFACTS_PUBLIC_READS=1
CRABBOX_ARTIFACTS_REGION=auto
CRABBOX_ARTIFACTS_ENDPOINT_URL=<account>.r2.cloudflarestorage.com
```

--------------------------------

### Provider Configuration Example (YAML)

Source: https://github.com/openclaw/crabbox/blob/main/docs/refactor/provider.md

Example of provider configuration sections within a central Config, using YAML.

```yaml
provider: daytona

daytona:
  snapshot: crabbox-ready
  user: daytona
  workRoot: /home/daytona/crabbox

islo:
  image: docker.io/library/ubuntu:24.04
  workdir: /workspace/crabbox
```

--------------------------------

### Quick Start: Lease, Egress, and Launch Browser

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/egress.md

This sequence leases a desktop+browser box, starts egress, and then launches a browser through the proxy, opening it in the WebVNC portal.

```sh
crabbox warmup --provider hetzner --desktop --browser
crabbox egress start --id swift-crab --profile discord --daemon
crabbox desktop launch --id swift-crab \
  --browser \
  --url https://example.com \
  --egress discord \
  --webvnc \
  --open
```

--------------------------------

### Per-PR Build Farm Setup

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/pond.md

Create a delegated pond of build helpers for each PR. This setup is designed as a work queue rather than a low-latency fabric.

```sh
crabbox warmup --pond "build-$PR" --slug coord --provider hetzner
for i in $(seq 1 30); do
  crabbox warmup --pond "build-$PR" --slug "helper-$i" --provider islo &
done
wait
```

--------------------------------

### Build and Run Node.js Service

Source: https://github.com/openclaw/crabbox/blob/main/docs/infrastructure.md

Installs dependencies, checks code, builds the Node.js service, and starts it with essential environment variables for PostgreSQL connection and service configuration.

```sh
npm ci --prefix worker
npm run check:node --prefix worker
npm run build:node --prefix worker

DATABASE_URL='postgresql://crabbox:password@db.example.com/crabbox?sslmode=verify-full&sslrootcert=/run/secrets/postgres-ca.pem' \
CRABBOX_SHARED_TOKEN=replace-me \
CRABBOX_SHARED_OWNER=alice@example.com \
CRABBOX_DEFAULT_ORG=example-org \
CRABBOX_PUBLIC_URL=https://broker.example.com \
npm run start:node --prefix worker
```

--------------------------------

### Cache Volume Configuration Example

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/cache.md

Example of how to configure and request a cache volume. Cache volumes persist rebuildable cache state across fresh leases.

```text
cache.volumes:
  my-npm-cache:
    source: npm
    path: /var/cache/crabbox/npm

--cache-volume my-npm-cache
```

--------------------------------

### Starting Egress with Profile or Allowlist

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/egress.md

Demonstrates how to start the Crabbox egress tunnel using either a predefined profile or a custom allowlist of host patterns.

```sh
crabbox egress start --id blue-lobster --profile slack
```

```sh
crabbox egress start --id blue-lobster --allow example.com,*.example.com
```

--------------------------------

### Hyper-V Configuration File Example

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/hyperv.md

Example of a YAML configuration file for the Hyper-V provider. Ensure sensitive information like passwords is not stored in repository config.

```yaml
hyperv:
  image: C:\Images\windows-crabbox.vhdx
  user: crabbox
  workRoot: C:\crabbox
  cpus: 4
  memory: 8192
  switch: Default Switch
  initPassword: false
```

--------------------------------

### Provider Readiness Check Example

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/doctor.md

This example shows the output format for a failed provider readiness check, including the provider, class of failure, and a remediation hint.

```text
failed  provider provider=gcp class=auth hint=check_gcp_project_credentials_and_compute_instances_list ...
```

--------------------------------

### Create Native Checkpoint for Slow Machine Setup

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/checkpoints.md

Use native checkpoints when machine setup is slow due to heavy toolchains, large package installs, or GPU drivers. This example shows warming up a provider, running a shell command to install CUDA, and then creating a checkpoint.

```sh
crabbox warmup --provider aws --class beast
crabbox run --id blue-lobster --shell 'sudo apt-get install -y cuda-toolkit && npm ci'
crabbox checkpoint create --id blue-lobster --name cuda-ready
```

--------------------------------

### Quick Start Commands for exe.dev Provider

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/exe-dev.md

Demonstrates basic commands for warming up, running tasks, SSHing into, and stopping VMs managed by the exe.dev provider.

```sh
ssh exe.dev whoami
crabbox warmup --provider exe-dev --slug smoke
crabbox run --provider exe-dev --id smoke -- pnpm test
crabbox ssh --provider exe-dev --id smoke
crabbox stop --provider exe-dev smoke
```

--------------------------------

### Start Apple Container Service

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/apple-container.md

Installs and starts the background service for Apple's container runtime. Ensure this is run before using the provider.

```sh
container system start
```

--------------------------------

### Quick Start: Warmup, Run, Checkpoint, and Fork

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/checkpoint.md

Demonstrates the workflow of warming a lease, running a command, creating a checkpoint, and then forking that checkpoint into a new lease for further execution.

```sh
# Warm a lease, do the expensive setup, then snapshot it
crabbox warmup --provider aws --class beast
crabbox run --id swift-crab --shell 'npm ci && npm test'
crabbox checkpoint create --id swift-crab --name after-npm-ci
# checkpoint created id=chk_abc123 kind=aws-ebs-snapshot resource=snap-... state=available region=eu-west-1 workdir=...

# Fork the checkpoint into a brand new lease
crabbox checkpoint fork chk_abc123 --class beast
# checkpoint forked id=chk_abc123 lease=cbx_... slug=purple-whale image=snap-... workdir=...

# Run against the forked lease
crabbox run --id purple-whale -- npm test
```

--------------------------------

### Install and Authenticate Phala CLI

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/phala.md

Install the Phala CLI, log in to your Phala account, and verify your access. This setup is required before using the Phala provider with Crabbox.

```sh
npm install -g phala        # or: npx phala ...
phala login                 # device flow; or export PHALA_CLOUD_API_KEY
phala status
crabbox doctor --provider phala
```

--------------------------------

### Proxmox Provider Configuration Example

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/proxmox.md

Example configuration for the Proxmox provider in a Crabbox setup. Specifies the Proxmox node, template ID, storage, network bridge, and cloud-init user.

```yaml
provider: proxmox
proxmox:
  node: pve1
  templateId: 9400
  storage: local-lvm
  bridge: vmbr0
  user: crabbox
```

--------------------------------

### Warmup and Access Desktop VM with Tart

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/tart.md

Use these commands to initialize a desktop-enabled VM with Tart and access its VNC interface through a browser viewer.

```sh
crabbox warmup --provider tart --desktop
```

```sh
crabbox webvnc --provider tart --id <lease-id>   # browser viewer (host-side bridge)
```

```sh
crabbox screenshot --provider tart --id <lease-id> --output desktop.png
```

--------------------------------

### Crabbox Post-Init Commands

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/init.md

Provides examples of commands to run after initializing a repository with Crabbox.

```sh
crabbox doctor              # validate the config
```

```sh
crabbox sync-plan           # preview what would sync
```

```sh
crabbox warmup              # acquire a lease
```

```sh
crabbox run -- pnpm test    # run a command
```

```sh
crabbox job run detected    # run the detected job, when generated
```

--------------------------------

### Build and Check Docs Site Locally

Source: https://github.com/openclaw/crabbox/blob/main/docs/README.md

Run these commands to build the documentation site locally and open it in your browser. Ensure you have the necessary scripts available in your project.

```sh
scripts/check-docs.sh
open dist/docs-site/index.html
```

--------------------------------

### Setup Islo SSH Access

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/islo.md

Run this command once to install the Islo CLI's SSH proxy configuration and certificate support.

```sh
islo ssh --setup
```

--------------------------------

### Create a Checkpoint

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/checkpoints.md

Example of creating a checkpoint with a specific ID and name. Useful for labeling checkpoints after significant operations like package installations.

```sh
crabbox checkpoint create --id blue-lobster --name after-npm-ci
# checkpoint created id=chk_abc123 ...
```

--------------------------------

### XCP-ng Quick Start Commands

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/xcp-ng.md

Set environment variables for XCP-ng credentials and configuration, then run doctor, warmup, run, ssh, stop, and cleanup commands.

```shell
export CRABBOX_XCP_NG_API_URL=https://xcp-pool.example.test
export CRABBOX_XCP_NG_USERNAME=crabbox@example.test
export CRABBOX_XCP_NG_PASSWORD='<api-password>'
export CRABBOX_XCP_NG_SR=default-sr
export CRABBOX_XCP_NG_TEMPLATE=crabbox-ubuntu-2404
export CRABBOX_XCP_NG_NETWORK=pool-network

crabbox doctor --provider xcp-ng --json
crabbox warmup --provider xcp-ng --keep --slug xcp-ng-smoke
crabbox run --provider xcp-ng --id xcp-ng-smoke --no-sync -- echo xcp-ng-ok
crabbox ssh --provider xcp-ng --id xcp-ng-smoke
crabbox stop --provider xcp-ng xcp-ng-smoke
crabbox cleanup --provider xcp-ng --dry-run
```

--------------------------------

### Open Desktop Session with Crabbox

Source: https://github.com/openclaw/crabbox/blob/main/docs/getting-started.md

Initiate a desktop session. Use `warmup --desktop` to prepare, then `vnc --open` to launch the VNC client.

```sh
crabbox warmup --desktop
crabbox vnc --id swift-crab --open
```

--------------------------------

### Run with Cache Volume

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/apple-container.md

Example of running a command within an Apple container while mounting a cache volume for the pnpm store. This helps speed up package installations.

```sh
crabbox run --provider apple-container \
  --cache-volume pnpm-store=my-app-apple-container-pnpm:/var/cache/crabbox/pnpm \
  -- pnpm test
```

--------------------------------

### Quick Start with Azure CLI Login

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/azure.md

Use this command for a simple setup where Crabbox detects your active Azure CLI session. No environment variables are needed.

```sh
az login
crabbox azure login
crabbox warmup --provider azure
```

--------------------------------

### Publish and Get Preview URL

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/codesandbox.md

Waits for a specific sandbox port to become available and prints the SDK host URL. Use the --json flag for structured output.

```bash
crabbox ports --provider codesandbox --id <lease> --publish 3000
```

```bash
crabbox ports --provider codesandbox --id <lease> --publish 3000 --json
```

--------------------------------

### Run crabbox whoami

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/whoami.md

Execute the `crabbox whoami` command to get a human-readable output of your identity. This is useful for confirming broker authentication before starting long-running tasks.

```sh
crabbox whoami
```

--------------------------------

### Crabbox Quick Start Commands

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/interactive-desktop-vnc.md

Common commands for initializing desktop environments, opening WebVNC sessions, checking status, diagnosing issues, and opening direct VNC connections.

```sh
crabbox warmup --desktop --browser
crabbox webvnc --id blue-lobster --open
crabbox webvnc status --id blue-lobster
crabbox desktop doctor --id blue-lobster
crabbox vnc --id blue-lobster --open
crabbox screenshot --id blue-lobster --output desktop.png
```

--------------------------------

### Warmup and Manage Retained VM

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/apple-vm.md

Prepare a virtual machine for reuse. This involves creating it once and then managing its lifecycle.

```shell
crabbox warmup --provider apple-vm --slug vz-dev
```

```shell
crabbox status --provider apple-vm --id vz-dev
```

```shell
crabbox run --provider apple-vm --id vz-dev -- systemctl is-system-running
```

```shell
crabbox ssh --provider apple-vm --id vz-dev
```

```shell
crabbox stop --provider apple-vm vz-dev
```

--------------------------------

### Low-Level Egress Commands

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/egress.md

Manually start the lease client and local host agent for non-Linux boxes or custom setups. The client listens on a specified loopback address and port.

```sh
crabbox egress host   --id swift-crab --profile discord
crabbox egress client --id swift-crab --listen 127.0.0.1:3128
```

--------------------------------

### Hydrate CI Job with Actions

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/capsules.md

Use this workflow when a failing CI job requires repository-owned setup like service containers or dependency installation. It hydrates the CI environment before replaying the capsule.

```shell
crabbox warmup
crabbox actions hydrate --id blue-lobster
crabbox capsule replay capsules/example-org-my-app-actions-123/capsule.yaml \
  --id blue-lobster \
  --keep
```

--------------------------------

### Warmup Hetzner Server for Desktop/Browser

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/hetzner.md

Prepares a Hetzner server for desktop and browser usage. This command is used to set up an environment for interactive sessions.

```sh
crabbox warmup --provider hetzner --desktop --browser
```

--------------------------------

### Warmup Parallels VM with Source and Snapshot

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/parallels.md

Initializes a Parallels VM using a specified source VM and snapshot. Sets the user and SSH port for subsequent connections.

```sh
crabbox warmup \
  --provider parallels \
  --target macos \
  --parallels-source "macOS Tahoe" \
  --parallels-source-snapshot fresh \
  --parallels-user alice \
  --ssh-port 22
```

--------------------------------

### Actions Hydration and Command Execution

Source: https://github.com/openclaw/crabbox/blob/main/docs/performance.md

Use Actions hydration for repeatable setup, allowing the repository's workflow to install dependencies and configure caches. Crabbox then attaches subsequent commands to the hydrated workspace.

```sh
bin/crabbox actions hydrate --id swift-crab
bin/crabbox run --id swift-crab -- pnpm test:changed:max
```

--------------------------------

### Register a Box as a GitHub Actions Self-Hosted Runner

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/actions.md

Registers an existing leased box as a self-hosted runner for GitHub Actions. This command installs the official runner package and starts it, allowing the workflow to run with full GitHub Actions capabilities. Supports Linux and Windows targets.

```sh
crabbox actions register --id blue-lobster
```

--------------------------------

### Project Setup for Direct Auth

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/gcp.md

Commands to enable the Compute Engine API and list zones for a specific project.

```sh
gcloud services enable compute.googleapis.com --project example-project-123
gcloud compute zones list --project example-project-123 --filter='name=europe-west2-a'
```

--------------------------------

### Example Slugs

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/identifiers.md

Illustrates the format of default and custom slugs.

```text
blue-lobster
amber-crab
silver-shrimp
```

--------------------------------

### Install Crabbox CLI using Homebrew

Source: https://github.com/openclaw/crabbox/blob/main/docs/README.md

Install the Crabbox CLI by adding the official repository to Homebrew and then installing the package. Verify the installation by checking the version.

```sh
brew install openclaw/tap/crabbox
```

--------------------------------

### Install Crabbox using Homebrew

Source: https://github.com/openclaw/crabbox/blob/main/README.md

Installs Crabbox via Homebrew and verifies the installation by checking the version.

```sh
brew install openclaw/tap/crabbox
crabbox --version
```

--------------------------------

### Manage a reusable Nebius VM lifecycle

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/nebius.md

This example shows how to warm up a reusable VM, run a command on it, and then stop it. It utilizes `--slug` for identification and `--keep` with `--ttl` for managing VM duration.

```sh
crabbox warmup --provider nebius --slug my-app --keep --ttl 30m
crabbox run --provider nebius --id my-app --no-sync -- uname -a
crabbox status --provider nebius --id my-app --wait
crabbox stop --provider nebius my-app
```

--------------------------------

### Start WebVNC Daemon Bridge

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/webvnc.md

Starts a WebVNC bridge in the background. It logs to a file, truncates it on each start, and opens the portal page if the bridge connects.

```sh
crabbox webvnc daemon start --id <lease-id-or-slug> --open
```

--------------------------------

### Start a Multipass Instance

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/multipass.md

Start a stopped Multipass virtual machine.

```bash
multipass start <name>
```

--------------------------------

### Minimal SSH Provider Example

Source: https://github.com/openclaw/crabbox/blob/main/docs/provider-backends.md

A basic implementation of the `cli.Provider` interface for an SSH lease provider. This example shows how to define the provider's name, specifications, and configuration logic.

```go
package example

import (
	"flag"

	"github.com/openclaw/crabbox/internal/cli"
)

func init() {
	cli.RegisterProvider(Provider{})
}

type Provider struct{}

func (Provider) Name() string      { return "example" }
func (Provider) Aliases() []string { return nil }

func (Provider) Spec() cli.ProviderSpec {
	return cli.ProviderSpec{
		Name: "example",
		Kind: cli.ProviderKindSSHLease,
		Targets: []cli.TargetSpec{
			{OS: "linux"},
		},
		Features: cli.FeatureSet{
			cli.FeatureSSH,
			cli.FeatureCrabboxSync,
		},
		Coordinator: cli.CoordinatorNever,
	}
}

func (Provider) RegisterFlags(*flag.FlagSet, cli.Config) any {
	return cli.NoProviderFlags()
}

func (Provider) ApplyFlags(*cli.Config, *flag.FlagSet, any) error {
	return nil
}

func (p Provider) Configure(cfg cli.Config, rt cli.Runtime) (cli.Backend, error) {
	return cli.NewExampleLeaseBackend(p.Spec(), cfg, rt), nil
}
```

--------------------------------

### Check Multipass Installation

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/multipass.md

Verify that the Multipass CLI is installed and accessible on your system.

```bash
multipass version
multipass list --format json
```

--------------------------------

### Local Container Configuration Example

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/local-container.md

Configure the local container runtime, base image, user, work directory, resource limits, and network settings.

```yaml
provider: local-container
localContainer:
  runtime: docker          # Docker-compatible CLI to invoke; detects docker/podman by default
  image: debian:bookworm   # base image for the lease
  user: crabbox            # SSH user created inside the container
  workRoot: /work/crabbox  # remote Crabbox work root
  cpus: 0                  # CPU limit; 0 leaves the runtime default
  memory: ""               # memory limit, e.g. 8g
  network: bridge          # container network
  dockerSocket: false      # mount the host Docker-compatible socket into the lease
```

--------------------------------

### AWS VNC Quick Start Commands

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/interactive-desktop-vnc.md

Commands to initiate desktop environments on AWS Windows and EC2 Mac instances and open VNC connections.

```sh
crabbox warmup --provider aws --target windows --desktop
crabbox vnc --id crimson-crab --open
```

```sh
crabbox warmup --provider aws --target macos --desktop --market on-demand
crabbox vnc --id silver-squid --open
```

--------------------------------

### Install Worker Dependencies

Source: https://github.com/openclaw/crabbox/blob/main/AGENTS.md

Installs the necessary Node.js dependencies for the Cloudflare Worker.

```bash
npm ci --prefix worker
```

--------------------------------

### Install and Build Cloudflare Worker

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/cloudflare.md

Installs dependencies, checks the Worker, and builds it for Cloudflare.

```sh
npm ci --prefix worker
npm run check --prefix worker
npm run build:cloudflare --prefix worker
```

--------------------------------

### Warmup Output Example

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/warmup.md

Example of the output format when `crabbox warmup` successfully leases and readies a box. It includes lease summary, SSH endpoint, and total duration.

```text
leased cbx_0123456789ab slug=swift-crab provider=hetzner server=... type=... ip=... idle_timeout=30m expires=...
ready ssh=root@... :2222 network=public workroot=/work/crabbox
warmup complete total=42.1s
```

--------------------------------

### Warmup Desktop Lease

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/webvnc.md

Prepares a desktop lease for use. This is often a prerequisite before opening a WebVNC session.

```sh
crabbox warmup --desktop
```

--------------------------------

### Start and Verify Crabbox Egress

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/egress.md

This snippet demonstrates the commands to warm up Crabbox, start the egress service, launch a desktop session with egress enabled, and check the egress status. Ensure Crabbox is warmed up before starting egress.

```sh
crabbox warmup --provider hetzner --desktop --browser
crabbox egress start --id swift-crab --profile discord --daemon
crabbox desktop launch --id swift-crab \
  --browser \
  --url https://example.com \
  --egress discord \
  --webvnc \
  --open
crabbox egress status --id swift-crab
```

--------------------------------

### Install Multipass on macOS with Homebrew

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/multipass.md

Install the Multipass application on macOS using the Homebrew package manager.

```bash
brew install --cask multipass
```

--------------------------------

### Warm up a candidate instance

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/image-bake-runbook.md

Boot a candidate instance with a specific provider image override. This is the first step in the image baking process.

```bash
CRABBOX_AWS_AMI=ami-1234567890abcdef0 \
crabbox warmup \
  --provider aws \
  --class standard \
  --desktop \
  --browser \
  --ttl 30m \
  --idle-timeout 10m
```

--------------------------------

### Manage Windows Instances with Crabbox CLI

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/vnc-windows.md

Use these commands to initialize a Windows instance, establish a VNC connection, and capture a screenshot. Ensure the instance is warmed up before attempting to connect or capture.

```sh
crabbox warmup --provider azure --target windows --desktop
```

```sh
crabbox vnc --id blue-lobster --open
```

```sh
crabbox screenshot --id blue-lobster --output windows.png
```

--------------------------------

### Install and Build Worker Dependencies

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/cloudflare-dynamic-workers.md

Installs dependencies, checks the Worker, and builds it for Cloudflare Dynamic Workers.

```sh
npm ci --prefix worker
npm run check --prefix worker
npm run build:cloudflare-dynamic-workers --prefix worker
```

--------------------------------

### Example Host Release Command

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/admin.md

Example of releasing a host using a positional ID and the force flag.

```text
crabbox admin hosts release h-0123456789abcdef0 --force
```

--------------------------------

### Start WebVNC Daemon

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/webvnc.md

Starts the WebVNC daemon for a specific lease ID, automatically opening the session in the browser.

```sh
crabbox webvnc daemon start --id swift-crab --open
```

--------------------------------

### Acquire and Run Nebius VM

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/nebius.md

Commands to create cost-bearing Nebius VMs. 'warmup' prepares a VM, while 'run' creates a VM and executes a command.

```sh
crabbox warmup --provider nebius --slug my-app --keep --ttl 20m
```

```sh
crabbox run --provider nebius --no-sync -- echo ok
```

--------------------------------

### Running a Crabbox Command with Profile and Preset

Source: https://github.com/openclaw/crabbox/blob/main/docs/features/configuration.md

Example command to run Crabbox using specific provider, profile, and preset, with scenario definition and proof output.

```sh
crabbox run --provider aws --profile live-qa --preset qa-live --scenario login-regression --emit-proof /tmp/proof.md --stop-after success

```

--------------------------------

### Start Egress

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/egress.md

Starts an egress tunnel. Requires a configured coordinator login. Supports coordinator-backed Linux SSH leases only.

```bash
crabbox egress start --coordinator <coordinator-url>
```

--------------------------------

### Start Subcommand Flags

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/egress.md

Details flags specific to the `start` subcommand, including profile selection, listen address, and daemonization.

```text
--profile <name>                 built-in allowlist profile
--allow <host,patterns>          comma-separated allowed host patterns
--listen 127.0.0.1:<port>        lease-local proxy listen address (default 127.0.0.1:3128)
--daemon                         run the local host bridge in the background
--target linux                   lease target (linux only; see Limitations)
--network auto|tailscale|public  how the CLI reaches the lease over SSH
```

--------------------------------

### Azure Windows Warmup

Source: https://github.com/openclaw/crabbox/blob/main/docs/commands/warmup.md

Leases an Azure instance configured for Windows.

```sh
crabbox warmup --provider azure --target windows
```

--------------------------------

### Install Modal Python Client

Source: https://github.com/openclaw/crabbox/blob/main/docs/providers/modal.md

Install the necessary Modal Python client using pip. This is a prerequisite for using the Modal provider.

```shell
pip install modal
```