yuanyeex
/
openclaw
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs(browser): update browser tool surface

main
Peter Steinberger 2025-12-20 02:53:26 +00:00
parent 6fc30962d6
commit b1a85d89d2
1 changed files with 4 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/browser.md
View File

@ -116,7 +116,6 @@ Basics:
Inspection: Inspection:
- `GET /screenshot` (CDP screenshot) - `GET /screenshot` (CDP screenshot)
- `POST /screenshot` (Playwright screenshot with ref/element) - `POST /screenshot` (Playwright screenshot with ref/element)
- `POST /eval` (CDP evaluate)
- `GET /query` - `GET /query`
- `GET /dom` - `GET /dom`
- `GET /snapshot` (`aria` | `domSnapshot` | `ai`) - `GET /snapshot` (`aria` | `domSnapshot` | `ai`)
@ -127,19 +126,17 @@ Debug-only endpoints (intentionally omitted for now):
- locator generation (dev convenience) - locator generation (dev convenience)
Actions: Actions:
- `POST /navigate`, `POST /back` - `POST /navigate`
- `POST /resize` - `POST /resize`
- `POST /click`, `POST /type`, `POST /press`, `POST /hover`, `POST /drag`, `POST /select` - `POST /click`, `POST /type`, `POST /press`, `POST /hover`, `POST /drag`, `POST /select`
- `POST /upload` (file chooser modal must be open) - `POST /upload` (arms the next file chooser)
- `POST /fill` (JSON field descriptors) - `POST /fill` (JSON field descriptors)
- `POST /dialog` (alert/confirm/prompt) - `POST /dialog` (arms the next alert/confirm/prompt)
- `POST /wait` (time/text/textGone) - `POST /wait` (time/text/textGone)
- `POST /evaluate` (function + optional ref) - `POST /evaluate` (function + optional ref)
- `POST /run` (function(page) → result)
- `GET /console` - `GET /console`
- `POST /pdf` - `POST /pdf`
- `POST /verify/element`, `POST /verify/text`, `POST /verify/list`, `POST /verify/value` - `POST /verify/element`, `POST /verify/text`, `POST /verify/list`, `POST /verify/value`
- `POST /mouse/move`, `POST /mouse/click`, `POST /mouse/drag`
### "Is it open or closed?" ### "Is it open or closed?"
@ -181,7 +178,6 @@ Inspection:
- `clawdis browser screenshot` - `clawdis browser screenshot`
- `clawdis browser screenshot --full-page` - `clawdis browser screenshot --full-page`
- `clawdis browser screenshot --ref 12` - `clawdis browser screenshot --ref 12`
- `clawdis browser eval "document.title"`
- `clawdis browser query "a" --limit 5` - `clawdis browser query "a" --limit 5`
- `clawdis browser dom --format text --max-chars 5000` - `clawdis browser dom --format text --max-chars 5000`
- `clawdis browser snapshot --format aria --limit 200` - `clawdis browser snapshot --format aria --limit 200`
@ -189,7 +185,6 @@ Inspection:
Actions: Actions:
- `clawdis browser navigate https://example.com` - `clawdis browser navigate https://example.com`
- `clawdis browser back`
- `clawdis browser resize 1280 720` - `clawdis browser resize 1280 720`
- `clawdis browser click 12 --double` - `clawdis browser click 12 --double`
- `clawdis browser type 23 "hello" --submit` - `clawdis browser type 23 "hello" --submit`
@ -202,19 +197,15 @@ Actions:
- `clawdis browser dialog --accept` - `clawdis browser dialog --accept`
- `clawdis browser wait --text "Done"` - `clawdis browser wait --text "Done"`
- `clawdis browser evaluate --fn '(el) => el.textContent' --ref 7` - `clawdis browser evaluate --fn '(el) => el.textContent' --ref 7`
- `clawdis browser run --code '(page) => page.title()'`
- `clawdis browser console --level error` - `clawdis browser console --level error`
- `clawdis browser pdf` - `clawdis browser pdf`
- `clawdis browser verify-element --role button --name "Submit"` - `clawdis browser verify-element --role button --name "Submit"`
- `clawdis browser verify-text "Welcome"` - `clawdis browser verify-text "Welcome"`
- `clawdis browser verify-list 3 ItemA ItemB` - `clawdis browser verify-list 3 ItemA ItemB`
- `clawdis browser verify-value --ref 4 --type textbox --value hello` - `clawdis browser verify-value --ref 4 --type textbox --value hello`
- `clawdis browser mouse-move --x 120 --y 240`
- `clawdis browser mouse-click --x 120 --y 240`
- `clawdis browser mouse-drag --start-x 10 --start-y 20 --end-x 200 --end-y 300`
Notes: Notes:
- `upload` and `dialog` only work when a file chooser or dialog is present. - `upload` and `dialog` are **arming** calls; run them before the click/press that triggers the chooser/dialog.
- `snapshot --format ai` returns Playwright-for-AI markup used for ref-based actions. - `snapshot --format ai` returns Playwright-for-AI markup used for ref-based actions.
## Security & privacy notes ## Security & privacy notes