From 8f451ab0dba9b0e8578a932fbe59eabb7d814625 Mon Sep 17 00:00:00 2001 From: Felarof Date: Mon, 26 Jan 2026 17:45:32 -0800 Subject: [PATCH] docs: add BrowserOS callout for smoother browser automation Highlight BrowserOS as an alternative that resolves common friction points: - No manual extension install (pre-installed automatically) - No "browser controlled externally" banner - No navigator.webdriver detection Co-Authored-By: Claude Opus 4.5 --- docs/tools/browser.md | 6 +++++- docs/tools/chrome-extension.md | 12 ++++++++++++ 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/docs/tools/browser.md b/docs/tools/browser.md index 3bf597e33..4e0f10e64 100644 --- a/docs/tools/browser.md +++ b/docs/tools/browser.md @@ -313,10 +313,14 @@ All control endpoints accept `?profile=`; the CLI uses `--browser-profile` ## Chrome extension relay (use your existing Chrome) -Clawdbot can also drive **your existing Chrome tabs** (no separate “clawd” Chrome instance) via a local CDP relay + a Chrome extension. +Clawdbot can also drive **your existing Chrome tabs** (no separate "clawd" Chrome instance) via a local CDP relay + a Chrome extension. Full guide: [Chrome extension](/tools/chrome-extension) + +For a friction-free alternative (no manual extension install, no "controlled externally" banner, no webdriver detection), see [BrowserOS](https://browseros.com). + + Flow: - You run a **browser control server** (Gateway on the same machine, or `clawdbot browser serve`). - A local **relay server** listens at a loopback `cdpUrl` (default: `http://127.0.0.1:18792`). diff --git a/docs/tools/chrome-extension.md b/docs/tools/chrome-extension.md index 1b1d0e9e0..a70bb8dc8 100644 --- a/docs/tools/chrome-extension.md +++ b/docs/tools/chrome-extension.md @@ -12,6 +12,18 @@ The Clawdbot Chrome extension lets the agent control your **existing Chrome tabs Attach/detach happens via a **single Chrome toolbar button**. + +**Want a smoother experience?** The manual extension install has some friction: +- You must load an unpacked extension via Developer Mode +- Chrome shows a "browser controlled externally" banner +- Sites may detect automation via `navigator.webdriver` + +[BrowserOS](https://browseros.com) (open-source Chromium fork) resolves all three: +- Clawdbot extension is pre-installed automatically +- No "controlled externally" banner +- `navigator.webdriver` flag is disabled + + ## What it is (concept) There are three parts: