为什么需要 Browser Relay?
想自动化操作浏览器,但工具配置复杂、代码一大串还容易报错;页面稍微变一下,脚本就失效,维护困难;遇到登录态、Cookie、JavaScript 渲染的页面,直接无法处理。
好消息来了!OpenClaw Browser Relay 直接用 AI 控制浏览器!不用记 API、不用写复杂脚本,只要会说话(打字)就行。从此以后:
- '帮我去某某网站查个数据' —— AI 自动打开浏览器、登录、查询、返回结果
- '把这个表单填了' —— AI 自动识别表单字段、填写、提交
- '截个图' —— AI 秒开浏览器、访问网址、截图、发给你
- '点页面上那个蓝色按钮' —— AI 视觉识别 + 点击,一气呵成
一句话:让浏览器听你的话,像聊天一样简单。
浏览器模式
OpenClaw 提供了三种浏览器控制模式,每种对应不同的使用场景,这里只介绍 Extension Relay 模式。
扩展中继模式(Extension Relay)
适用场景:
- 需要访问已登录的网站(Gmail、飞书、企业后台)
- 想复用浏览器的 Cookie 和 Session
- 临时性、轻量级的自动化任务
工作原理: 在你现有的 Chrome 浏览器上安装一个扩展程序,这个扩展会通过 WebSocket 连接到 OpenClaw 网关。当 AI 需要操作浏览器时,命令通过网关→扩展→浏览器的链路执行。
优点:
- 直接使用你的登录状态(不用重新登录)
- 和你自己的浏览器共享配置(代理、插件等)
- 轻量级,不需要启动额外的浏览器实例
缺点:
- 安全性较低(AI 理论上能访问你所有标签页)
- 依赖扩展稳定性(扩展挂了就得重装)
- 高级功能受限(截图、ARIA 快照需要额外配置)
配置方法:
- 安装扩展:
openclaw browser extension install
- 获取扩展路径:
openclaw browser extension path
- 在 Chrome 中加载:
- 打开
chrome://extensions - 启用'开发者模式'
- 选择上面命令输出的路径
- 打开
- 配置扩展:
- 点击扩展图标
- 输入端口:18789,没有修改的话默认就是这个
- 在下面输入 token,显示绿色的一行表示成功
找到下面的 token,cat ~/.openclaw/openclaw.json
点击'加载已解压的扩展程序'
使用 要先打开谷歌浏览器,开一个标签,点击下地址栏右边图标,会有个 on 显示在图标上 (如果是个感叹号,说明没有配置对)。此时则可以使用 openclaw 操作谷歌浏览器了。
踩坑记录
- 在配置插件的时候会遇到连接不上,或者能够打开浏览器但是不能控制网页,执行 openclaw gateway status 有如下错误:
gateway connect failed: Error: pairing required ◇ Error: gateway closed (1008): pairing required Gateway target: ws://127.0.0.1:18789 Source: local loopback Config: /home/user/.openclaw/openclaw.json Bind: loopback
解决方法


