browser-automation

Controls web pages through the OpenClaw browser tool with tab management and stale ref recovery.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill browser-automation-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: browser-automation
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/extensions/browser/skills/browser-automation
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill browser-automation-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Multi-step browser automation often breaks due to stale element refs, duplicate tabs, lost login state, and silent timeouts. This Skill provides an operating loop for the OpenClaw browser tool that keeps tabs, snapshots, and actions consistent across long flows. ## Core Features & Use Cases - Stable Tab Management: Open tabs with labels, reuse existing tabs, and target them via suggestedTargetId instead of fragile raw DevTools IDs. - Snapshot-Driven Actions: Read the page with aria refs before clicking, and re-snapshot after navigation or modal changes to avoid stale ref failures. - Blocker Detection and Recovery: Diagnose login, captcha, 2FA, and permission screens, recover from stale refs with a fresh snapshot, and report exact manual steps to the user. - Use Case: Joining a Google Meet requires handling camera permission prompts, reusing a labeled meet tab across retries, and reporting sign-in blockers instead of looping. ## Quick Start Use the browser automation skill to open a labeled tab for example.com, snapshot it, and click the sign-in button.

Frequently Asked Questions about browser-automation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate multi-step browser flows with the OpenClaw browser tool?

Check browser status first, open tabs with a label, snapshot the page to get refs, then act on those refs with the same targetId. Re-snapshot after every navigation or modal change before the next action.

How to fix stale element ref errors in browser automation?

Snapshot the same targetId again, locate the current visible control, and retry once with the new ref. If the UI has moved to a blocker state like login or captcha, report the blocker instead of retrying in a loop.

Can I use my existing browser session and cookies with OpenClaw?

Yes, use profile="user" to attach to your running Chromium-based browser with existing cookies and login state. For these sessions, omit timeoutMs on actions like type, fill, hover, and evaluate since that driver rejects per-call timeout overrides.

Why does browser automation fail on Google Meet joins?

Camera and microphone permission screens are normal progress, not login failures. Use one labeled tab per meeting, click the microphone option when voice is required, and report any Google sign-in or 2FA prompt as a manual step for the user.

What targetId should I pass to browser tool actions?

Pass the suggestedTargetId returned by tabs or open calls, which is the label if one exists or a stable tabId like t1. Avoid raw DevTools target IDs and bare numeric positions, which are only valid for the CLI tab select helper.