logo

quickActions

icon

OpenClaw Browser Sandbox

Headless Chromium browser sandbox that can be controlled via Chrome DevTools Protocol (CDP). Use this with OpenClaw or other services that need browser automation capabilities.

PlatformZeabur
Deployed177
PublisherzeaburZeabur
Deployed177 times
PublisherzeaburZeabur
Created2026-01-28
Services
service icon
Tags
BrowserAutomationChromiumCDP

OpenClaw Browser Sandbox

A headless Chromium browser that can be controlled via Chrome DevTools Protocol (CDP).

Use Cases

  • Browser automation with OpenClaw
  • Web scraping
  • Automated testing
  • Screenshot services

How to Connect

Other services in the same Zeabur project can connect via:

http://openclaw-sandbox-browser:9222

CDP Endpoints

  • GET /json/version - Browser version info
  • GET /json/list - List open tabs
  • GET /json/new?url=<url> - Open new tab
  • WebSocket connections for DevTools protocol

Configuration for OpenClaw

Option 1: Paste config to OpenClaw Copy the following configuration and paste it to OpenClaw chat, asking it to update your config file:

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

Example prompt: "Please add this browser configuration to my openclaw.json file"

Option 2: OpenClaw Web UI

  1. Open OpenClaw Web UI (click the domain link in Zeabur dashboard)
  2. Go to Settings page
  3. Find Browser section and enable Browser Tool
  4. Enable Attach Only mode
  5. Set Default Profile to remote
  6. Expand Profiles section and click + Add Entry
  7. Fill in the profile settings:
    • Profile name: remote
    • Cdp Url: http://openclaw-sandbox-browser:9222
    • Color: #FF4500 (optional)
  8. Save settings - changes apply automatically

For detailed configuration options, see the official documentation.

Resources

  • Recommended: 1 vCPU, 1 GB RAM
  • Heavy usage: 2 vCPU, 2 GB RAM

Testing Connection

After deploying, test the connection using curl from OpenClaw terminal:

curl http://openclaw-sandbox-browser:9222/json/version

If successful, you should see a JSON response like:

{"Browser":"Chrome/...","Protocol-Version":"1.3",...}

Ignorable Errors

The following error messages in logs are normal and can be safely ignored:

  • Failed to connect to the bus - No D-Bus in container (expected)
  • Failed to adjust OOM score - Permission limitation (doesn't affect functionality)
  • DEPRECATED_ENDPOINT - Google Cloud Messaging not needed for headless mode

Documentation