diff --git a/docs/cli/browser.md b/docs/cli/browser.md
index 4c91bcb2e20..715ce29f343 100644
--- a/docs/cli/browser.md
+++ b/docs/cli/browser.md
@@ -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).
diff --git a/docs/tools/browser.md b/docs/tools/browser.md
index 6fec66f2f0f..4fde174b7ee 100644
--- a/docs/tools/browser.md
+++ b/docs/tools/browser.md
@@ -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.