OpenClaw Browser Relay 接入与浏览器控制实战

为什么需要 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 快照需要额外配置）

配置方法：

1. 安装扩展：

openclaw browser extension install

2. 获取扩展路径：

openclaw browser extension path 

3. 在 Chrome 中加载：
   • 打开 chrome://extensions
   • 启用'开发者模式'
   • 选择上面命令输出的路径
4. 配置扩展：
   • 点击扩展图标
   • 输入端口：18789，没有修改的话默认就是这个
   • 在下面输入 token，显示绿色的一行表示成功

找到下面的 token，cat ~/.openclaw/openclaw.json

点击'加载已解压的扩展程序'

使用 要先打开谷歌浏览器，开一个标签，点击下地址栏右边图标，会有个 on 显示在图标上 (如果是个感叹号，说明没有配置对)。此时则可以使用 openclaw 操作谷歌浏览器了。

踩坑记录

1. 在配置插件的时候会遇到连接不上，或者能够打开浏览器但是不能控制网页，执行 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