- name
- se-browser-automation
- description
- Browser automation patterns and best practices for OpenClaw browser control. Use when navigating web apps, filling forms, clicking elements, or extracting data from websites. Covers GHL, Lovable, and general SPA navigation patterns.
- version
- 1.0.0
Browser Automation Skill
Profile
- Use profile:
openclawfor all automated browsing - Browser is managed by OpenClaw gateway
Core Patterns
Navigation
- Use
browser navigatewith direct URLs when possible (faster than clicking through menus) - Always
sleep 4-6after navigation — SPAs load content asynchronously - If page seems blank, try
screenshotfirst — content may be rendered but not in DOM snapshot
Element Interaction
- Use
snapshotto get element refs, thenactwith refs - For iframe content: use
frameparameter in snapshot - If compact snapshot misses content, try full snapshot or screenshot
- GHL and complex SPAs often render in iframes — check both main page and iframe
Screenshots vs Snapshots
- Snapshot — DOM tree, good for finding clickable refs
- Screenshot — Visual image, good for understanding what's actually on screen
- When snapshot shows empty/minimal content but screenshot shows a full page → content is in iframe or shadow DOM
Login Flows
- Navigate to login page
- Snapshot to find form fields
- Click + type credentials
- Handle 2FA (check email, enter code)
- Wait for redirect (sleep 4-6 seconds)
- Verify logged in via screenshot
Common Issues
- Popups/modals blocking → Press Escape
- Lazy-loaded content → Wait longer, refresh, or navigate directly via URL
- iframe content → Use frame parameter or evaluate JS to find iframe
- evaluate function errors → No
const,let, or arrow functions. Usevarandfunction(){}syntax. - ref required errors → Must use ref from snapshot, can't use text selectors
SPA-Specific Tips
- SPAs don't fully reload on navigation — URL changes but DOM updates incrementally
- Some content only appears after JavaScript execution
- If clicking a link doesn't work, try navigating directly to the URL
- F5 refresh can help when SPA state gets stuck