Documentation

Integrate ProxyBase Relay with OpenClaw in minutes.

1. Configure Your OpenClaw Settings

For first-time users, the native automation framework must be informed on how to route DevTools traffic securely through our relay. Provide the following prompt to your OpenClaw agent or manually amend your configuration file.

Prompt to Edit OpenClaw Configuration:

Edit my OpenClaw config so the browser section becomes:

{
  "browser": {
    "remoteCdpTimeoutMs": 2000,
    "remoteCdpHandshakeTimeoutMs": 4000,
    "headless": true,
    "noSandbox": true,
    "defaultProfile": "proxybase",
    "profiles": {
      "proxybase": {
        "cdpUrl": "<CDP_URL>",
        "color": "#3498db"
      }
    }
  }
}

Important:
- Keep the profile name exactly "proxybase".
- Set defaultProfile to "proxybase".
- remoteCdpTimeoutMs and remoteCdpHandshakeTimeoutMs are required and must stay exactly as shown.
- headless must be true.
- noSandbox must be true.
- Leave cdpUrl as a placeholder string "<CDP_URL>" because I will replace it dynamically later.
- Preserve any unrelated config outside the browser section.
- Save the change to ~/.openclaw/openclaw.json.

2. Start Your First Session

Once OpenClaw is configured with the persistent proxybase profile, generate a session using your installed browser extension.

Pin the extension and click the icon to open the ProxyBase dashboard.
Press Create Relay to securely generate a new WebSocket pipeline.
Copy the CDP URL provided in the dashboard overlay.
Replace the <CDP_URL> token in your ~/.openclaw/openclaw.json file with your copied relay URL.
Launch OpenClaw! The automation script will natively execute against your live browser session via our edge routing node.