docs(browser): document inspection diagnostics · openclaw/openclaw@60e7b69

Recent Commits to openclaw:main

steipete · 2026-04-25 · via Recent Commits to openclaw:main

Original file line number	Diff line number	Diff line change
`@@ -113,6 +113,7 @@ Docs: https://docs.openclaw.ai`
`113`	`113`	- Browser/tool: expose stable `tabId` handles such as `t1` plus optional tab labels, and accept those handles anywhere a browser tab target is needed. Thanks @steipete.
`114`	`114`	- Browser/tool: return `suggestedTargetId` first in tab payloads so agents naturally reuse labels or stable tab handles instead of raw DevTools ids. Thanks @steipete.
`115`	`115`	- Browser/tool: bundle a `browser-automation` skill with the multi-step snapshot, stable-tab, stale-ref, and manual-blocker loop for agent-controlled pages. Thanks @steipete.
	`116`	+- Browser/tool: add `openclaw browser doctor`, URL-expanded snapshots, direct labeled screenshots, and clearer tab-target errors for agents that accidentally pass positional indexes. Thanks @steipete.
`116`	`117`	`- Plugins/Google Meet: use browser automation to classify and clear Meet's microphone-choice interstitial during browser meeting creation, and reuse in-progress create tabs on retry instead of opening duplicates. Thanks @steipete.`
`117`	`118`	`- Codex/GPT-5.4: harden fallback, auth-profile, tool-schema, and replay edge cases across native and embedded runtime paths. (#70743) Thanks @100yenadmin.`
`118`	`119`	`- Models/fallback: resolve bare fallback model provider ids before model switching, so configured fallback chains keep working when a fallback is named without an explicit provider prefix. Thanks @steipete.`

Original file line number	Diff line number	Diff line change
@@ -40,6 +40,7 @@ If `start` fails with `not reachable after start`, troubleshoot CDP readiness fi
`40`	`40`	`Minimal sequence:`
`41`	`41`
`42`	`42`	```bash
	`43`	`+openclaw browser --browser-profile openclaw doctor`
`43`	`44`	`openclaw browser --browser-profile openclaw start`
`44`	`45`	`openclaw browser --browser-profile openclaw tabs`
`45`	`46`	`openclaw browser --browser-profile openclaw open https://example.com`
`@@ -51,6 +52,7 @@ Detailed guidance: [Browser troubleshooting](/tools/browser#cdp-startup-failure-`
`51`	`52`
`52`	`53`	```bash
`53`	`54`	`openclaw browser status`
	`55`	`+openclaw browser doctor`
`54`	`56`	`openclaw browser start`
`55`	`57`	`openclaw browser stop`
`56`	`58`	`openclaw browser --browser-profile openclaw reset-profile`
`@@ -132,6 +134,7 @@ Snapshot:`
`132`	`134`
`133`	`135`	```bash
`134`	`136`	`openclaw browser snapshot`
	`137`	`+openclaw browser snapshot --urls`
`135`	`138`	```
`136`	`139`
`137`	`140`	`Screenshot:`
`@@ -140,6 +143,7 @@ Screenshot:`
`140`	`143`	`openclaw browser screenshot`
`141`	`144`	`openclaw browser screenshot --full-page`
`142`	`145`	`openclaw browser screenshot --ref e12`
	`146`	`+openclaw browser screenshot --labels`
`143`	`147`	```
`144`	`148`
`145`	`149`	`Notes:`
`@@ -148,6 +152,10 @@ Notes:`
`148`	`152`	or `--element`.
`149`	`153`	- `existing-session` / `user` profiles support page screenshots and `--ref`
`150`	`154`	screenshots from snapshot output, but not CSS `--element` screenshots.
	`155`	+- `--labels` overlays current snapshot refs on the screenshot.
	`156`	+- `snapshot --urls` appends discovered link destinations to AI snapshots so
	`157`	`+ agents can choose direct navigation targets instead of guessing from link`
	`158`	`+ text alone.`
`151`	`159`
`152`	`160`	`Navigate/click/type (ref-based UI automation):`
`153`	`161`

Original file line number	Diff line number	Diff line change
`@@ -141,11 +141,13 @@ openclaw browser close abcd1234`
`141`	`141`	`openclaw browser screenshot`
`142`	`142`	`openclaw browser screenshot --full-page`
`143`	`143`	`openclaw browser screenshot --ref 12 # or --ref e12`
	`144`	`+openclaw browser screenshot --labels`
`144`	`145`	`openclaw browser snapshot`
`145`	`146`	`openclaw browser snapshot --format aria --limit 200`
`146`	`147`	`openclaw browser snapshot --interactive --compact --depth 6`
`147`	`148`	`openclaw browser snapshot --efficient`
`148`	`149`	`openclaw browser snapshot --labels`
	`150`	`+openclaw browser snapshot --urls`
`149`	`151`	`openclaw browser snapshot --selector "#main" --interactive`
`150`	`152`	`openclaw browser snapshot --frame "iframe#main" --interactive`
`151`	`153`	`openclaw browser console --level error`
`@@ -221,6 +223,7 @@ Snapshot flags at a glance:`
`221`	`223`	- `--efficient` (or `--mode efficient`): compact role snapshot preset. Set `browser.snapshotDefaults.mode: "efficient"` to make this the default (see [Gateway configuration](/gateway/configuration-reference#browser)).
`222`	`224`	- `--interactive`, `--compact`, `--depth`, `--selector` force a role snapshot with `ref=e12` refs. `--frame "<iframe>"` scopes role snapshots to an iframe.
`223`	`225`	- `--labels` adds a viewport-only screenshot with overlayed ref labels (prints `MEDIA:<path>`).
	`226`	+- `--urls` appends discovered link destinations to AI snapshots.
`224`	`227`
`225`	`228`	`## Snapshots and refs`
`226`	`229`
`@@ -236,6 +239,8 @@ OpenClaw supports two “snapshot” styles:`
`236`	`239`	- Actions: `openclaw browser click e12`, `openclaw browser highlight e12`.
`237`	`240`	- Internally, the ref is resolved via `getByRole(...)` (plus `nth()` for duplicates).
`238`	`241`	- Add `--labels` to include a viewport screenshot with overlayed `e12` labels.
	`242`	+ - Add `--urls` when link text is ambiguous and the agent needs concrete
	`243`	`+ navigation targets.`
`239`	`244`
`240`	`245`	`Ref behavior:`
`241`	`246`

Original file line number	Diff line number	Diff line change
`@@ -34,6 +34,7 @@ agent automation and verification.`
`34`	`34`	`## Quick start`
`35`	`35`
`36`	`36`	```bash
	`37`	`+openclaw browser --browser-profile openclaw doctor`
`37`	`38`	`openclaw browser --browser-profile openclaw status`
`38`	`39`	`openclaw browser --browser-profile openclaw start`
`39`	`40`	`openclaw browser --browser-profile openclaw open https://example.com`
`@@ -603,7 +604,8 @@ How it maps:`
`603`	`604`
`604`	`605`	- `browser snapshot` returns a stable UI tree (AI or ARIA).
`605`	`606`	- `browser act` uses the snapshot `ref` IDs to click/type/drag/select.
`606`		-- `browser screenshot` captures pixels (full page or element).
	`607`	+- `browser screenshot` captures pixels (full page, element, or labeled refs).
	`608`	+- `browser doctor` checks Gateway, plugin, profile, browser, and tab readiness.
`607`	`609`	- `browser` accepts:
`608`	`610`	- `profile` to choose a named browser profile (openclaw, chrome, or remote CDP).
`609`	`611`	- `target` (`sandbox` \| `host` \| `node`) to select where the browser lives.

此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。原文来自 — 版权归原作者所有。

推荐订阅源

Recent Commits to openclaw:main