diff --git a/docs/tools/browser.md b/docs/tools/browser.md index d632e713068..bfb12777f0a 100644 --- a/docs/tools/browser.md +++ b/docs/tools/browser.md @@ -205,9 +205,45 @@ the standard HTTP-based CDP discovery (`/json/version`). OpenClaw supports both: discover the WebSocket debugger URL, then connects. - **WebSocket endpoints** (`ws://` / `wss://`) — OpenClaw connects directly, skipping `/json/version`. Use this for services like - [Browserbase](https://www.browserbase.com) or any provider that hands you a + [Browser Use](https://www.browser-use.com), + [Browserbase](https://www.browserbase.com), or any provider that hands you a WebSocket URL. +### Browser Use + +[Browser Use](https://www.browser-use.com) is a cloud browser platform with +anti-detect stealth, CAPTCHA solving, persistent profiles, and residential +proxies. + +```json5 +{ + browser: { + enabled: true, + defaultProfile: "browseruse", + remoteCdpTimeoutMs: 5000, + remoteCdpHandshakeTimeoutMs: 15000, + profiles: { + browseruse: { + // All Browser Use session params can be added as query params. + // See: https://docs.browser-use.com/cloud/api-v2/browsers/create-browser-session + cdpUrl: "wss://connect.browser-use.com?apiKey=&timeout=240&profileId=&proxyCountryCode=us", + color: "#ff750e", + }, + }, + }, +} +``` + +Notes: + +- [Sign up](https://www.browser-use.com) and copy your **API Key** from the + dashboard. +- Replace `` with your real Browser Use API key. +- All [Browser Use session parameters](https://docs.browser-use.com/cloud/api-v2/browsers/create-browser-session) + (timeout, profileId, proxyCountryCode, screen size, custom proxy, etc.) + are passed as query params in the `cdpUrl`. +- See [browser-use.com](https://www.browser-use.com) for more information. + ### Browserbase [Browserbase](https://www.browserbase.com) is a cloud platform for running