abby-browser-skill

# Abby Browser Skill _基于 OpenClaw 内置浏览器工具封装_ --- ## 解决的问题 让爸爸可以用自然语言控制浏览器，不需要记住复杂命令。 --- ## 核心功能 | 功能 | 命令 | 示例 | |------|------|------| | 打开网页 | `open` | 打开 Google | | 截图 | `screenshot` | 截取当前页面 | | 点击 | `click` | 点击按钮 | | 输入 | `type` | 输入文字 | | 填表单 | `fill` | 填写表单 | | 提取数据 | `snapshot` | 获取页面内容 | | 等待 | `wait` | 等待加载 | | 滚动 | `scroll` | 滚动页面 | --- ## 使用方法 ### 在对话中 ``` 爸爸：帮我打开 Google Abby：好的爸爸！让我打开 Google... [执行 openclaw browser open https://google.com] ✅ 已打开 Google 爸爸：帮我截图 Abby：好的，截个图... [执行 openclaw browser screenshot] 📸 截图已保存 爸爸：帮我点击登录按钮 Abby：好的... [执行 openclaw browser click 12] ✅ 已点击 ``` ### 常用命令 ```bash # 打开网页 openclaw browser open https://example.com # 截图 openclaw browser screenshot openclaw browser screenshot --full-page # 点击元素 (需要先 snapshot 获取 ref) openclaw browser click 12 openclaw browser click 12 --double # 输入文字 openclaw browser type 12 "hello world" # 填写表单 openclaw browser fill --fields '[{"ref":"1","value":"xxx"}]' # 获取页面快照 openclaw browser snapshot openclaw browser snapshot --format aria # 等待 openclaw browser wait --text "Done" openclaw browser wait --selector ".content" # 滚动 openclaw browser evaluate --fn 'window.scrollTo(0, document.body.scrollHeight)' ``` --- ## 封装脚本 ### scripts/open.py 打开网页的封装脚本。 ### scripts/screenshot.py 截图的封装脚本。 ### scripts/click.py 点击元素的封装脚本。 ### scripts/form.py 表单填写的封装脚本。 ### scripts/extract.py 数据提取的封装脚本。 --- ## 重要概念 ### 1. Element Reference (ref) 每次执行 `snapshot` 后，元素会有一个编号 (ref)： ``` <button ref="12">登录</button> <input ref="23" /> ``` 点击 ref=12：`openclaw browser click 12` ### 2. Snapshot 格式 - `--format ai` (默认) - AI 理解 - `--format aria` - 辅助功能树 ### 3. 等待加载 操作前最好等待： ```bash openclaw browser wait --text "加载完成" ``` --- ## 安全考虑 - ❌ 不自动执行危险操作 - ✅ 执行前确认 - ✅ 记录操作日志 - ✅ 异常处理 --- ## 依赖 - OpenClaw browser 工具 - Chrome/Chromium 浏览器 --- ## 相关文档 - [OpenClaw Browser Docs](https://docs.openclaw.ai/cli/browser) --- _创建于 2026-02-15_