docs: clarify browser allowlist defaults and risks
This commit is contained in:
@@ -1471,6 +1471,7 @@ Allowlists for remote control:
|
||||
- `allowedControlUrls`: exact control URLs permitted for `target: "custom"`.
|
||||
- `allowedControlHosts`: hostnames permitted (hostname only, no port).
|
||||
- `allowedControlPorts`: ports permitted (defaults: http=80, https=443).
|
||||
Defaults: all allowlists are unset (no restriction). `allowHostControl` defaults to false.
|
||||
|
||||
### `models` (custom providers + base URLs)
|
||||
|
||||
|
||||
@@ -199,6 +199,15 @@ Also consider agent workspace access inside the sandbox:
|
||||
|
||||
Important: `tools.elevated` is the global baseline escape hatch that runs bash on the host. Keep `tools.elevated.allowFrom` tight and don’t enable it for strangers. You can further restrict elevated per agent via `agents.list[].tools.elevated`. See [Elevated Mode](/tools/elevated).
|
||||
|
||||
## Browser control risks
|
||||
|
||||
Enabling browser control gives the model the ability to drive a real browser.
|
||||
If that browser profile already contains logged-in sessions, the model can
|
||||
access those accounts and data. Treat browser profiles as **sensitive state**:
|
||||
- Prefer a dedicated profile for the agent (the default `clawd` profile).
|
||||
- Avoid pointing the agent at your personal daily-driver profile.
|
||||
- Keep host browser control disabled for sandboxed agents unless you trust them.
|
||||
|
||||
## Per-agent access profiles (multi-agent)
|
||||
|
||||
With multi-agent routing, each agent can have its own sandbox + tool policy:
|
||||
|
||||
@@ -245,5 +245,6 @@ How it maps:
|
||||
- In sandboxed sessions, `target: "host"` requires `agents.defaults.sandbox.browser.allowHostControl=true`.
|
||||
- If `target` is omitted: sandboxed sessions default to `sandbox`, non-sandbox sessions default to `host`.
|
||||
- Sandbox allowlists can restrict `target: "custom"` to specific URLs/hosts/ports.
|
||||
- Defaults: allowlists unset (no restriction), and sandbox host control is disabled.
|
||||
|
||||
This keeps the agent deterministic and avoids brittle selectors.
|
||||
|
||||
Reference in New Issue
Block a user