OpenClaw setup - Browserbase Documentation

This guide recommends two Browserbase setup paths for OpenClaw, in this order:

Use OpenClaw’s built-in browser plugin with a Browserbase profile.
Use the Browse CLI if you specifically want browse workflows.

Recommended: built-in browser plugin

This is the preferred path because it keeps you inside OpenClaw’s first-class browser workflow while moving execution onto Browserbase infrastructure.

Get your Browserbase API key

Create a Browserbase account, then copy your API key from the Overview dashboard.

Configure a Browserbase browser profile

Add a Browserbase-backed profile in ~/.openclaw/openclaw.json:

{
  "browser": {
    "enabled": true,
    "defaultProfile": "browserbase",
    "remoteCdpTimeoutMs": 3000,
    "remoteCdpHandshakeTimeoutMs": 5000,
    "profiles": {
      "browserbase": {
        "cdpUrl": "wss://connect.browserbase.com?apiKey=<BROWSERBASE_API_KEY>",
        "color": "#F97316"
      }
    }
  }
}

Restart OpenClaw or the Gateway

Restart OpenClaw so the browser service picks up the new Browserbase profile.

Verify the Browserbase profile

Test the profile with OpenClaw’s native browser commands:

openclaw browser --browser-profile browserbase status
openclaw browser --browser-profile browserbase open https://example.com
openclaw browser --browser-profile browserbase snapshot

Browserbase creates a browser session automatically when OpenClaw connects over WebSocket, so there is no separate manual session-creation step in this flow.

Alternative: Browse CLI

If your workflow is centered on browse commands instead of OpenClaw’s native browser commands, use the Browse CLI.

Install the Browse CLI

npm i -g browse

Authenticate with your Browserbase API key

export BROWSERBASE_API_KEY="your_api_key"

Use `browse` commands for Browserbase workflows

Example commands:

browse projects list
browse sessions get <session_id>
browse fetch https://example.com
browse search "browser automation" --num-results 5

For the full CLI workflow reference, see the Browse CLI guide.

​Recommended: built-in browser plugin

​Alternative: Browse CLI

Recommended: built-in browser plugin

Alternative: Browse CLI