docs: add browserless remote CDP example

This commit is contained in:
Peter Steinberger
2026-01-16 09:05:19 +00:00
parent 9838a2850f
commit 3d3ec9d972

View File

@@ -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 to the CDP WebSocket. Prefer environment variables or secrets managers for
tokens instead of committing them to config files. 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=<BROWSERLESS_API_KEY>",
color: "#00AA00"
}
}
}
}
```
Notes:
- Replace `<BROWSERLESS_API_KEY>` 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 ### Running the control server on the browser machine
Run a standalone browser control server (recommended when your Gateway is remote): Run a standalone browser control server (recommended when your Gateway is remote):