Openclaw browser Commands Guide: Complete Reference
Quick Start
The openclaw browser command set gives you full control over a managed Chrome instance for web automation, testing, and data extraction. This guide covers the essential commands you need to get started quickly.
For more OpenClaw automation tools, check out our guide on Web Tools Openclaw and the Firecrawl Web Scraping integration.
Profile Management
Browser profiles let you switch between isolated Chrome instances or connect to your existing browser:
openclaw browser profiles — List all profiles
openclaw browser create-profile --name <name> — Create new profile
openclaw browser delete-profile --name <name> — Remove a profile
openclaw browser reset-profile — Reset current profile state
Tab Management
Control browser tabs and navigation:
openclaw browser tabs — List open tabs
openclaw browser tab new — Open blank tab
openclaw browser open <url> — Navigate to URL
openclaw browser tab close <n> — Close tab by index
Page Inspection
Capture and analyze page content:
openclaw browser snapshot — Capture UI tree for AI processing
openclaw browser screenshot — Save viewport image
openclaw browser screenshot --full-page — Capture entire page
openclaw browser pdf — Print page to PDF
openclaw browser console — View browser logs
Action Commands
Interact with page elements (requires snapshot ref IDs):
openclaw browser click <ref> — Click element
openclaw browser type <ref> <text> --submit — Type and submit
openclaw browser press Enter — Press key
openclaw browser select <ref> <value> — Select dropdown option
openclaw browser upload <paths> — Upload files
State and Environment
Manipulate browser state for testing:
openclaw browser cookies — List cookies
openclaw browser cookies clear — Clear all cookies
openclaw browser set offline on — Emulate offline mode
openclaw browser set geo <lat> <lon> — Set geolocation
openclaw browser set device "iPhone 14" — Emulate mobile device
Common Flags
These work with most browser commands:
--json — Output machine-readable JSON
--timeout <ms> — Set request timeout
--browser-profile <name> — Use specific profile
Example Workflow
Here is a complete automation example:
openclaw browser open https://example.com
openclaw browser snapshot
openclaw browser type "1" "search query" --submit
openclaw browser wait --time 2000
openclaw browser screenshot --full-page
Troubleshooting
- Browser will not start: Run openclaw browser status to check service health
- Actions fail: Always run snapshot first to get current ref IDs
- Stale elements: Page changed? Re-run snapshot to refresh references
- Slow loading: Use --timeout 30000 to increase wait time
