steel-browser

# Steel Browser Skill

Cloud browser-use via [Steel.dev](https://steel.dev) + Playwright Python SDK.
Ideal for web automation, scraping, form filling, and AI agent browser loops.

## Prerequisites

```bash
pip install steel-sdk playwright
export STEEL_API_KEY=your_key_here
```

Get your API key at https://app.steel.dev → Settings → API Keys (free: 100 browser hours).

Steel API key should be set in OpenClaw config or environment:
```bash
openclaw config set env.STEEL_API_KEY "your_key"
```

## State Management

- `start_session.sh` saves session ID to `~/.steel_state`
- All scripts auto-load it from there
- Override anytime with `export STEEL_SESSION_ID=<id>`
- Sessions persist until `release_session.sh` or timeout

## Scripts

| Script | Usage | Description |
|---|---|---|
| `start_session.sh` | `[--proxy] [--captcha] [--timeout MS]` | Create session; prints SESSION_ID + VIEWER_URL |
| `release_session.sh` | `[SESSION_ID]` | Release session |
| `list_sessions.sh` | _(none)_ | List active sessions |
| `navigate.sh` | `URL [--wait-until networkidle]` | Go to URL |
| `screenshot.sh` | `[OUTPUT.png] [--full-page]` | Take screenshot |
| `click.sh` | `SELECTOR` | Click by CSS/text/aria selector |
| `click_coords.sh` | `X Y [--right] [--double]` | Click at pixel coords (fallback) |
| `type.sh` | `SELECTOR "text"` | Fill input field |
| `press_key.sh` | `KEY` | Press key (e.g. `Enter`, `Control+a`) |
| `scroll.sh` | `AMOUNT\|--to-bottom\|--to-top\|SELECTOR` | Scroll page |
| `hover.sh` | `SELECTOR` | Hover over element |
| `select.sh` | `SELECTOR VALUE` | Select dropdown option |
| `get_content.sh` | `[--html] [SELECTOR]` | Extract page text or HTML |
| `eval_js.sh` | `"js expression"` | Execute JavaScript, print result |
| `wait_for.sh` | `SELECTOR [TIMEOUT_MS]` | Wait for element to appear |
| `get_url.sh` | _(none)_ | Print current URL and page title |

## Selector Examples

Steel uses Playwright selectors — much more powerful than pixel coords:

```bash
# By CSS
click....