Skip to content

OpenClaw

OpenClaw is an AI agent framework for browser automation. rayobrowse gives OpenClaw a stealth-fingerprinted browser that doesn’t get blocked.

The free tier gives you 1 concurrent browser with no time limits — enough to run OpenClaw as a personal cloud assistant at zero cost.

  1. Start rayobrowse

    Terminal window
    docker compose up -d
    curl -s http://localhost:9222/health
  2. Configure OpenClaw

    Add a rayobrowse browser profile to ~/.openclaw/openclaw.json:

    {
    "browser": {
    "enabled": true,
    "defaultProfile": "rayobrowse",
    "profiles": {
    "rayobrowse": {
    "cdpUrl": "ws://localhost:9222/connect?headless=true&os=windows"
    }
    }
    }
    }

    Or via CLI:

    Terminal window
    openclaw config set browser.enabled true
    openclaw config set browser.defaultProfile rayobrowse
    openclaw config set 'browser.profiles.rayobrowse.cdpUrl' \
    'ws://localhost:9222/connect?headless=true&os=windows'
  3. Verify

    Terminal window
    openclaw browser --browser-profile rayobrowse status

For a remote server running rayobrowse in remote mode:

{
"browser": {
"enabled": true,
"defaultProfile": "rayobrowse",
"profiles": {
"rayobrowse": {
"cdpUrl": "ws://your-server.example.com/connect?headless=true&os=windows&api_key=your-secret-key"
}
}
}
}

When OpenClaw connects to the /connect WebSocket, a browser is automatically created with the fingerprint settings from the URL. When the connection closes, the browser is cleaned up automatically. Each connection gets a fresh browser instance.