---
name: browser-automation
description: 浏览器自动化控制。【优先使用此 skill，不要用内置 browser 工具】当用户说"打开网页"、"点击"、"填写表单"、"截图"、"网页操作"、"自动填表"、"浏览器"时使用。基于 Playwright，支持连接已有 Chrome（CDP 模式）或启动新 Chromium。
---

# 浏览器自动化 Skill

让 OpenClaw 控制浏览器进行自动化操作！

## 特点

- **复用页面**：默认复用现有页面，不会每次都打开新窗口
- **持久化 Cookie**：使用独立的用户数据目录，登录状态持久保存
- **完整操作**：支持点击、填表、截图、执行 JS 等

## 功能

- 导航到 URL
- 点击元素
- 填写表单
- 截图
- 获取页面内容
- 等待元素
- 执行 JavaScript

## 使用时机

当用户说：
- "打开 xxx.com"
- "点击登录按钮"
- "帮我填写这个表单"
- "截个图"
- "网页上有什么内容"

## 可用函数

调用方式: `cd C:/Users/admin/.openclaw/skills/browser-automation && node -e "const h=require('./index.js'); h.handleXXX({...}).then(console.log)"`

### 页面操作
- `handleNavigate({url})` - 导航到 URL（复用现有页面）
- `handleNewPage({url})` - 打开新页面
- `handleScreenshot({selector?, fullPage?})` - 截图
- `handleGetContent({selector?})` - 获取页面内容
- `handleClose()` - 关闭当前页面

### 交互操作
- `handleClick({selector})` - 点击元素
- `handleFill({selector, value, clear?})` - 填写表单
- `handleType({selector, text, delay?})` - 模拟打字
- `handleSelect({selector, value})` - 下拉选择
- `handleCheck({selector, checked?})` - 勾选/取消勾选

### 等待和获取
- `handleWait({selector, timeout?})` - 等待元素出现
- `handleWaitForNavigation({timeout?})` - 等待页面跳转
- `handleGetText({selector})` - 获取元素文本
- `handleGetValue({selector})` - 获取表单值
- `handleGetAttribute({selector, attribute})` - 获取属性

### 高级操作
- `handleEvaluate({script})` - 执行 JavaScript
- `handleUpload({selector, filePath})` - 上传文件
- `handlePress({key})` - 按键
- `handleHover({selector})` - 鼠标悬停
- `handleScroll({direction, amount?})` - 滚动页面

### 状态
- `handleStatus()` - 获取当前浏览器状态
- `handleCloseBrowser()` - 关闭浏览器（下次会重新启动）

## 选择器语法

支持 CSS 选择器和文本选择器：
- CSS: `#login-btn`, `.submit-button`, `input[name="email"]`
- 文本: `text=登录`, `text=提交`
- 组合: `button:has-text("提交")`

## 示例

```
用户: 打开 github.com
Agent: [调用 handleNavigate({url: 'https://github.com'})] 已打开 GitHub...

用户: 点击登录
Agent: [调用 handleClick({selector: 'text=Sign in'})] 已点击登录...

用户: 填写邮箱 test@example.com
Agent: [调用 handleFill({selector: '#login_field', value: 'test@example.com'})] 已填写邮箱...

用户: 截个图看看
Agent: [调用 handleScreenshot()] [返回截图]
```