diff --git a/docs/tools/browser.md b/docs/tools/browser.md index f1d9b7700..793b75a75 100644 --- a/docs/tools/browser.md +++ b/docs/tools/browser.md @@ -166,6 +166,34 @@ Clawdbot preserves the auth when calling `/json/*` endpoints and when connecting to the CDP WebSocket. Prefer environment variables or secrets managers for tokens instead of committing them to config files. +### Browserless (hosted remote CDP) + +[Browserless](https://browserless.io) is a hosted Chromium service that exposes +CDP endpoints over HTTPS. You can point a Clawdbot browser profile at a +Browserless region endpoint and authenticate with your API key. + +Example: +```json5 +{ + browser: { + enabled: true, + defaultProfile: "browserless", + remoteCdpTimeoutMs: 2000, + remoteCdpHandshakeTimeoutMs: 4000, + profiles: { + browserless: { + cdpUrl: "https://production-sfo.browserless.io?token=", + color: "#00AA00" + } + } + } +} +``` + +Notes: +- Replace `` with your real Browserless token. +- Choose the region endpoint that matches your Browserless account (see their docs). + ### Running the control server on the browser machine Run a standalone browser control server (recommended when your Gateway is remote):