AI 操控浏览器：OpenClaw Browser Relay 接入指南

为什么需要 Browser Relay？

痛点：

• 自动化操作浏览器配置复杂、代码易报错
• 页面变动导致脚本失效，维护成本高
• 登录态、Cookie、JavaScript 渲染页面难以处理

解决方案： OpenClaw Browser Relay 使用 AI 控制浏览器。无需记忆 API 或编写复杂脚本，通过自然语言指令即可实现：

• 自动打开浏览器、登录、查询并返回结果
• 自动识别表单字段、填写并提交
• 访问网址、截图并发送
• 视觉识别并点击页面对象

一句话：让浏览器听你的话，像聊天一样简单。

浏览器模式

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（查看 ~/.openclaw/openclaw.json）

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

踩坑记录

问题： 连接不上或无法控制网页，执行 openclaw gateway status 报错 pairing required。

原因： OpenClaw 采用类似蓝牙的配对机制，防止恶意软件通过 localhost 控制浏览器窃取数据。客户端需显式授权。

解决方法：

1. 停止网关：

openclaw gateway stop

2. 删除旧身份限制文件：

 -rf ~/.openclaw/identity/ ~/.openclaw/devices/