OpenClaw Sandbox Browser

Headless Chromium browser sandbox for OpenClaw.

This container provides a headless Chromium browser that OpenClaw can control via Chrome DevTools Protocol (CDP).

# Pull the image
docker pull ghcr.io/canyugs/openclaw-sandbox-browser:main

# Run in headless mode
docker run -d -p 9222:9222 ghcr.io/canyugs/openclaw-sandbox-browser:main

# Test CDP is working
curl http://localhost:9222/json/version

Note: Legacy environment variables MOLTBOT_BROWSER_* and CLAWDBOT_BROWSER_* are also supported for backward compatibility.

In your OpenClaw configuration (openclaw.json):

{
  "browser": {
    "enabled": true,
    "attachOnly": true,
    "defaultProfile": "remote",
    "profiles": {
      "remote": {
        "cdpUrl": "http://openclaw-sandbox-browser:9222",
        "color": "#FF4500"
      }
    }
  }
}

By default, the browser runs in headless mode for better performance. To enable visual debugging:

# Run with desktop mode enabled
docker run -d \
  -p 9222:9222 \
  -p 6080:6080 \
  -p 5900:5900 \
  -e OPENCLAW_BROWSER_HEADLESS=0 \
  ghcr.io/canyugs/openclaw-sandbox-browser:main

docker build -t openclaw-sandbox-browser:local .

• Based on debian:bookworm-slim for minimal footprint
• Includes Chromium with CJK fonts support
• Uses Caddy as reverse proxy for CDP (handles Host header rewrite)
• Includes X11 virtual framebuffer (Xvfb) for non-headless mode
• Includes x11vnc and noVNC for remote desktop access

MIT