是什么
BrowserWing是一个本地运行的浏览器自动化HTTP服务。OpenClaw通过调用它的API来控制真实浏览器——导航、点击、输入、截图、提取数据都行。
适合处理:需要登录的页面、JavaScript渲染的内容、复杂交互流程。
核心能力
- 页面导航(navigate/go-back/reload)
- 元素操作(click/type/select/hover)
- 数据提取(extract/get-text/page-text)
- 页面分析(snapshot获取元素树)
- 高级操作(screenshot/evaluate JS/batch批量)
- 标签页管理(新建/切换/关闭tab)
- 表单填写(fill-form一步搞定多字段)
工作流程
- 启动BrowserWing服务
- 调用
/navigate打开目标页面 - 调用
/snapshot获取页面元素和RefID - 用RefID(如
@e1)点击/输入/提取 - 页面变化后重新snapshot更新RefID
典型场景
- 自动登录后台系统抓取数据
- 批量填写表单提交
- 竞品价格/内容监控
- 需要绕过JS渲染的网页采集
⚠️ Boss攻略 — 这些坑先别踩
- BrowserWing服务必须提前启动(默认端口8080),否则所有API调用都会返回连接拒绝错误——OpenClaw不会自动帮你启动它
- 每次页面跳转后必须重新调用/snapshot获取新的元素RefID,旧的RefID(如@e1)5分钟内失效,用过期ID操作会失败
- 动态加载的内容(无限滚动、懒加载图片)需要先调用/scroll-to-bottom或/wait等待内容出现,直接extract会漏数据
- 批量操作建议用/batch接口合并多步,单独发5个请求比1个batch请求慢3-5倍,高频调用容易被目标网站封IP
相关案例整理中,很快会上线 📝