OpenClaw Browser Automation

## Overview

Automate repeatable browser tasks on authorized websites — navigate pages, extract structured data, fill forms, capture screenshots as evidence, and run visual regression tests. Built on three proven skills: **browser-use** for interactive browser control, **firecrawl** for web scraping and content extraction, and **webapp-testing** for Playwright-based UI testing.

## Quick Start

1. Install the plugin:
   ```bash
   npx skillstore add @openclaw-browser-automation
   ```
2. Use **browser-use** to navigate and interact with a page:
   ```
   browser-use open https://dashboard.example.com
   browser-use state
   browser-use click 5
   browser-use screenshot
   ```
3. Use **firecrawl** to extract page content as structured markdown:
   ```
   firecrawl scrape https://example.com/data
   ```
4. Use **webapp-testing** to run a Playwright visual test:
   ```
   python scripts/with_server.py --url http://localhost:3000 -- pytest test_ui.py
   ```

## Full Workflow Example

**Login → Extract Table Data → Screenshot Evidence → Export**

1. Open your target dashboard with **browser-use**
2. Fill login form and submit credentials
3. Navigate to the data table page
4. Use **firecrawl** to scrape the table into clean JSON/CSV
5. Take a screenshot with **browser-use** for audit trail
6. Validate the output with **webapp-testing** assertions

## Key Skills

- **browser-use** — Navigate URLs, click elements, fill forms, type text, take screenshots, extract data from rendered pages. Maintains persistent browser sessions across commands.
- **firecrawl** — Scrape any URL into clean markdown optimized for LLM context. Handles JavaScript rendering, bypasses common blocks, supports crawling and site mapping.
- **webapp-testing** — Playwright-based toolkit for verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing console logs.

## Safety & Limitations

- **Authorized sites only** — Only automate websites you have explicit permission to access
- **Captcha/2FA fallback** — When CAPTCHA, 2FA, or anti-bot challenges appear, the workflow pauses for human intervention. Do not attempt to bypass security measures.
- **Page structure changes** — If selectors break due to site updates, re-run `browser-use state` to refresh element indices
- **Rate limiting** — Respect target site rate limits; add delays between requests when scraping

## Tips

- Combine with **openclaw-automation-healthcheck** for automated monitoring dashboards
- Use `browser-use screenshot` at key steps to create visual audit trails
- For large-scale extraction, prefer **firecrawl** over browser-use as it handles JavaScript rendering server-side