{
  "title": "Sandbox CLI",
  "content": "Manage Docker-based sandbox containers for isolated agent execution.\n\nOpenClaw can run agents in isolated Docker containers for security. The `sandbox` commands help you manage these containers, especially after updates or configuration changes.\n\n### `openclaw sandbox explain`\n\nInspect the **effective** sandbox mode/scope/workspace access, sandbox tool policy, and elevated gates (with fix-it config key paths).\n\n### `openclaw sandbox list`\n\nList all sandbox containers with their status and configuration.\n\n* Container name and status (running/stopped)\n* Docker image and whether it matches config\n* Age (time since creation)\n* Idle time (time since last use)\n* Associated session/agent\n\n### `openclaw sandbox recreate`\n\nRemove sandbox containers to force recreation with updated images/config.\n\n* `--all`: Recreate all sandbox containers\n* `--session <key>`: Recreate container for specific session\n* `--agent <id>`: Recreate containers for specific agent\n* `--browser`: Only recreate browser containers\n* `--force`: Skip confirmation prompt\n\n**Important:** Containers are automatically recreated when the agent is next used.\n\n### After updating Docker images",
  "code_samples": [
    {
      "code": "### `openclaw sandbox list`\n\nList all sandbox containers with their status and configuration.",
      "language": "unknown"
    },
    {
      "code": "**Output includes:**\n\n* Container name and status (running/stopped)\n* Docker image and whether it matches config\n* Age (time since creation)\n* Idle time (time since last use)\n* Associated session/agent\n\n### `openclaw sandbox recreate`\n\nRemove sandbox containers to force recreation with updated images/config.",
      "language": "unknown"
    },
    {
      "code": "**Options:**\n\n* `--all`: Recreate all sandbox containers\n* `--session <key>`: Recreate container for specific session\n* `--agent <id>`: Recreate containers for specific agent\n* `--browser`: Only recreate browser containers\n* `--force`: Skip confirmation prompt\n\n**Important:** Containers are automatically recreated when the agent is next used.\n\n## Use Cases\n\n### After updating Docker images",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h2",
      "text": "Overview",
      "id": "overview"
    },
    {
      "level": "h2",
      "text": "Commands",
      "id": "commands"
    },
    {
      "level": "h3",
      "text": "`openclaw sandbox explain`",
      "id": "`openclaw-sandbox-explain`"
    },
    {
      "level": "h3",
      "text": "`openclaw sandbox list`",
      "id": "`openclaw-sandbox-list`"
    },
    {
      "level": "h3",
      "text": "`openclaw sandbox recreate`",
      "id": "`openclaw-sandbox-recreate`"
    },
    {
      "level": "h2",
      "text": "Use Cases",
      "id": "use-cases"
    },
    {
      "level": "h3",
      "text": "After updating Docker images",
      "id": "after-updating-docker-images"
    }
  ],
  "url": "llms-txt#sandbox-cli",
  "links": []
}