Abby Browser

# 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

---

_创建于 2026-02-15_