celesto sandbox list

celesto sandbox list shows the sandboxes on your machine. Use it to find a sandbox name, check whether one is still running, or feed sandbox data into a script.

Synopsis

celesto sandbox list [OPTIONS]

Examples

List running sandboxes

celesto sandbox list

List every sandbox

celesto sandbox list --all

Filter by state

celesto sandbox list --status stopped

Filter by preset

A preset is a ready-made sandbox setup for an agent. Use --preset to show only sandboxes created by one preset. The table adds a Preset column so you can tell which agent produced each sandbox:

celesto sandbox list --preset openclaw
# NAME              PRESET     STATUS   PID
# openclaw-work     openclaw   running  12345

Add --all to include that preset’s sandboxes in every state:

celesto sandbox list --preset openclaw --all

Preset filtering uses information saved when Celesto creates a sandbox. Sandboxes created by older Celesto releases and manually prepared sandboxes remain available through celesto sandbox list --all, but do not appear in preset-filtered results. Their Preset column shows -.

For OpenClaw specifically, the shortcut celesto openclaw list shows only OpenClaw sandboxes and accepts the same --all, --status, and --json flags. See Work with OpenClaw for the full workflow.

Use JSON output

celesto sandbox list --json

{
  "ok": true,
  "command": "sandbox.list",
  "exit_code": 0,
  "data": {
    "filters": {
      "all": false,
      "status": "running",
      "preset": null
    },
    "vms": [
      {
        "name": "openclaw-work",
        "preset": "openclaw",
        "status": "running",
        "pid": 12345,
        "ip_address": "172.16.0.2",
        "ssh_port": 2222,
        "warnings": []
      }
    ]
  },
  "error": null
}

Options

flag

Show every sandbox, including stopped, created, paused, and errored sandboxes.

string

Show only sandboxes in one state. Use one of the states printed by celesto sandbox list --all.

string

Show only sandboxes created by this preset, such as openclaw or codex. You can combine this with --all or --status.

flag

Print a JSON envelope instead of a table. Each sandbox includes its stored preset, and filters includes the active preset filter.

Use either --all or --status, not both.

celesto sandbox create - Create a sandbox
celesto sandbox info - Show details for one sandbox
celesto sandbox delete - Delete one or more sandboxes

Celesto CLI

Celesto API

Celesto CLI

Agentor API

celesto sandbox list

Synopsis

Examples

List running sandboxes

List every sandbox

Filter by state

Filter by preset

Use JSON output

Options

​Synopsis

​Examples

​List running sandboxes

​List every sandbox

​Filter by state

​Filter by preset

​Use JSON output

​Options

​Related commands

Synopsis

Examples

List running sandboxes

List every sandbox

Filter by state

Filter by preset

Use JSON output

Options

Related commands