docs: clarify when browser serve is needed
This commit is contained in:
@@ -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)
|
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
|
## Sandboxing and memory
|
||||||
|
|
||||||
### Is there a dedicated sandboxing doc?
|
### Is there a dedicated sandboxing doc?
|
||||||
|
|||||||
@@ -221,6 +221,9 @@ Flow:
|
|||||||
- You click the **Clawdbot Browser Relay** extension icon on a tab to attach.
|
- 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.
|
- 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
|
### Setup
|
||||||
|
|
||||||
1) Create a profile that uses the extension driver:
|
1) Create a profile that uses the extension driver:
|
||||||
|
|||||||
@@ -70,6 +70,21 @@ Then target it:
|
|||||||
- Badge shows `ON` when attached.
|
- Badge shows `ON` when attached.
|
||||||
- Click again to detach.
|
- 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 Gateway’s 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)
|
## Remote Gateway (recommended: Tailscale Serve)
|
||||||
|
|
||||||
Goal: Gateway runs on one machine, but Chrome runs somewhere else.
|
Goal: Gateway runs on one machine, but Chrome runs somewhere else.
|
||||||
|
|||||||
Reference in New Issue
Block a user