docs: refresh browser existing session docs

This commit is contained in:
Peter Steinberger
2026-04-04 11:51:01 +01:00
parent 5583bda61d
commit 53d3fbcef6
2 changed files with 22 additions and 2 deletions

View File

@@ -190,6 +190,16 @@ openclaw browser --browser-profile chrome-live tabs
This path is host-only. For Docker, headless servers, Browserless, or other remote setups, use a CDP profile instead.
Current existing-session limits:
- snapshot-driven actions use refs, not CSS selectors
- `click` is left-click only
- `type` does not support `slowly=true`
- `press` does not support `delayMs`
- `wait --load networkidle` is not supported
- `responsebody`, download interception, PDF export, and batch actions still
require a managed browser or raw CDP profile
## Remote browser control (node host proxy)
If the Gateway runs on a different machine than the browser, run a **node host** on the machine that has Chrome/Brave/Edge/Chromium. The Gateway will proxy browser actions to that node (no separate browser control server required).

View File

@@ -481,10 +481,20 @@ Notes:
Chromium user data directory.
- Existing-session screenshots support page captures and `--ref` element
captures from snapshots, but not CSS `--element` selectors.
- Existing-session actions are still more limited than the managed browser
path:
- `click`, `type`, `hover`, `scrollIntoView`, `drag`, and `select` require
snapshot refs instead of CSS selectors
- `click` is left-button only (no button overrides or modifiers)
- `type` does not support `slowly=true`; use `fill` or `press`
- `press` does not support `delayMs`
- `hover`, `scrollIntoView`, `drag`, `select`, and `evaluate` do not support
per-call timeout overrides
- `select` currently supports a single value only
- Existing-session `wait --url` supports exact, substring, and glob patterns
like other browser drivers. `wait --load networkidle` is not supported yet.
- Some features still require the managed browser path, such as PDF export and
download interception.
- Some features still require the managed browser path, including batch
actions, PDF export, download interception, and `responsebody`.
- Existing-session is host-local. If Chrome lives on a different machine or a
different network namespace, use remote CDP or a node host instead.