docs: explain sandboxed browser control

This commit is contained in:
Peter Steinberger
2026-01-15 05:17:12 +00:00
parent 757243993c
commit 2d066b8715
2 changed files with 36 additions and 0 deletions

View File

@@ -224,6 +224,13 @@ Flow:
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).
### Sandboxed sessions
If the agent session is sandboxed, the `browser` tool may default to `target="sandbox"` (sandbox browser).
Chrome extension relay takeover requires host browser control, so either:
- run the session unsandboxed, or
- set `agents.defaults.sandbox.browser.allowHostControl: true` and use `target="host"` when calling the tool.
### Setup
1) Create a profile that uses the extension driver: