SKILL.md
浏览器自动化 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()] [返回截图]