docs: clarify when browser serve is needed

This commit is contained in:
Peter Steinberger
2026-01-15 05:15:33 +00:00
parent 57c66fe813
commit 612cdac4c3
3 changed files with 20 additions and 0 deletions

View File

@@ -413,6 +413,8 @@ Then Chrome → `chrome://extensions` → enable “Developer mode” → “Loa
Full guide (including remote Gateway via Tailscale + security notes): [Chrome extension](/tools/chrome-extension)
If the Gateway runs on the same machine as Chrome (default setup), you usually **do not** need `clawdbot browser serve`.
## Sandboxing and memory
### Is there a dedicated sandboxing doc?

View File

@@ -221,6 +221,9 @@ Flow:
- You click the **Clawdbot Browser Relay** extension icon on a tab to attach.
- The agent controls that tab via the normal `browser` tool, by selecting the right profile.
If the Gateway runs on the same machine as Chrome (default setup), you usually **do not** need `clawdbot browser serve`.
Use `browser serve` only when the Gateway runs elsewhere (remote mode).
### Setup
1) Create a profile that uses the extension driver:

View File

@@ -70,6 +70,21 @@ Then target it:
- Badge shows `ON` when attached.
- Click again to detach.
## Do I need `clawdbot browser serve`?
### Local Gateway (same machine as Chrome) — usually **no**
If the Gateway is running on the same machine as Chrome and your `browser.controlUrl` is loopback (default),
you typically **do not** need `clawdbot browser serve`.
The Gateways built-in browser control server will start on `http://127.0.0.1:18791/` and Clawdbot will
auto-start the local relay server when you use a profile with `driver="extension"`.
### Remote Gateway (Gateway runs elsewhere) — **yes**
If your Gateway runs on another machine, run `clawdbot browser serve` on the machine that runs Chrome
(and publish it via Tailscale Serve / TLS). See the section below.
## Remote Gateway (recommended: Tailscale Serve)
Goal: Gateway runs on one machine, but Chrome runs somewhere else.