为什么需要 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
解决方法
