From 1d79c6c19cd89de3fda5f825d2839475b91abc2a Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Sat, 25 Apr 2026 06:33:51 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@209d50b52c67bc8bf8a115a48d564005fd585aa4

---
 .openclaw-sync/source.json    | 4 ++--
 docs/cli/browser.md           | 1 +
 docs/tools/browser-control.md | 3 ++-
 docs/tools/browser.md         | 2 +-
 4 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 0f330afbb..3d7ee4f61 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "b59ba1dc8ea587e05534554a92c8fce287b53e95",
-  "syncedAt": "2026-04-25T06:20:14.650Z"
+  "sha": "209d50b52c67bc8bf8a115a48d564005fd585aa4",
+  "syncedAt": "2026-04-25T06:32:30.902Z"
 }
diff --git a/docs/cli/browser.md b/docs/cli/browser.md
index 032ed8792..38ab18d4a 100644
--- a/docs/cli/browser.md
+++ b/docs/cli/browser.md
@@ -164,6 +164,7 @@ Navigate/click/type (ref-based UI automation):
 ```bash
 openclaw browser navigate https://example.com
 openclaw browser click <ref>
+openclaw browser click-coords 120 340
 openclaw browser type <ref> "hello"
 openclaw browser press Enter
 openclaw browser hover <ref>
diff --git a/docs/tools/browser-control.md b/docs/tools/browser-control.md
index 7cc5878b3..31164ec16 100644
--- a/docs/tools/browser-control.md
+++ b/docs/tools/browser-control.md
@@ -165,6 +165,7 @@ openclaw browser responsebody "**/api" --max-chars 5000
 openclaw browser navigate https://example.com
 openclaw browser resize 1280 720
 openclaw browser click 12 --double           # or e12 for role refs
+openclaw browser click-coords 120 340        # viewport coordinates
 openclaw browser type 23 "hello" --submit
 openclaw browser press Enter
 openclaw browser hover 44
@@ -212,7 +213,7 @@ openclaw browser set device "iPhone 14"
 Notes:
 
 - `upload` and `dialog` are **arming** calls; run them before the click/press that triggers the chooser/dialog.
-- `click`/`type`/etc require a `ref` from `snapshot` (numeric `12` or role ref `e12`). CSS selectors are intentionally not supported for actions.
+- `click`/`type`/etc require a `ref` from `snapshot` (numeric `12` or role ref `e12`). CSS selectors are intentionally not supported for actions. Use `click-coords` when the visible viewport position is the only reliable target.
 - Download, trace, and upload paths are constrained to OpenClaw temp roots: `/tmp/openclaw{,/downloads,/uploads}` (fallback: `${os.tmpdir()}/openclaw/...`).
 - `upload` can also set file inputs directly via `--input-ref` or `--element`.
 
diff --git a/docs/tools/browser.md b/docs/tools/browser.md
index aa3ad316d..50962d93f 100644
--- a/docs/tools/browser.md
+++ b/docs/tools/browser.md
@@ -529,7 +529,7 @@ Notes:
 Compared to the managed `openclaw` profile, existing-session drivers are more constrained:
 
 - **Screenshots** — page captures and `--ref` element captures work; CSS `--element` selectors do not. `--full-page` cannot combine with `--ref` or `--element`. Playwright is not required for page or ref-based element screenshots.
-- **Actions** — `click`, `type`, `hover`, `scrollIntoView`, `drag`, and `select` require snapshot refs (no CSS selectors). `click` is left-button only. `type` does not support `slowly=true`; use `fill` or `press`. `press` does not support `delayMs`. `type`, `hover`, `scrollIntoView`, `drag`, `select`, `fill`, and `evaluate` do not support per-call timeouts. `select` accepts a single value.
+- **Actions** — `click`, `type`, `hover`, `scrollIntoView`, `drag`, and `select` require snapshot refs (no CSS selectors). `click-coords` clicks visible viewport coordinates and does not require a snapshot ref. `click` is left-button only. `type` does not support `slowly=true`; use `fill` or `press`. `press` does not support `delayMs`. `type`, `hover`, `scrollIntoView`, `drag`, `select`, `fill`, and `evaluate` do not support per-call timeouts. `select` accepts a single value.
 - **Wait / upload / dialog** — `wait --url` supports exact, substring, and glob patterns; `wait --load networkidle` is not supported. Upload hooks require `ref` or `inputRef`, one file at a time, no CSS `element`. Dialog hooks do not support timeout overrides.
 - **Managed-only features** — batch actions, PDF export, download interception, and `responsebody` still require the managed browser path.