Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.browserbase.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide recommends two Browserbase setup paths for OpenClaw, in this order:
  1. Use OpenClaw’s built-in browser plugin with a Browserbase profile.
  2. Use the Browse CLI if you specifically want browse workflows.
This is the preferred path because it keeps you inside OpenClaw’s first-class browser workflow while moving execution onto Browserbase infrastructure.
1

Get your Browserbase API key

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

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"
      }
    }
  }
}
3

Restart OpenClaw or the Gateway

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

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.
1

Install the Browse CLI

npm i -g browse
2

Authenticate with your Browserbase API key

export BROWSERBASE_API_KEY="your_api_key"
3

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.