OpenClaw Browser Relay：AI 直接控制浏览器指南

OpenClaw Browser Relay 是一款 Chrome 扩展程序，作为 OpenClaw AI 框架的核心组件，它通过 CDP（Chrome DevTools Protocol）协议，让 AI 代理直接控制当前使用的浏览器标签页，实现无缝自动化。

核心原理与架构

它由三部分组成，共同构建 AI 与浏览器的桥梁：

• OpenClaw Gateway/Node：AI 指令的接收与转发中心（默认端口 18792）。
• 本地中继服务器：在本地监听 CDP 协议，作为网关与扩展之间的通信桥梁。
• Chrome 扩展：通过 chrome.debugger API 附着到当前标签页，转发 CDP 指令。

工作流程：AI指令 → Gateway → 中继服务器 → 扩展 → 浏览器

主要功能

• 直接操控现有浏览器：复用登录状态、Cookie、插件，无需启动独立浏览器实例。
• 完整网页交互：点击、输入、滚动、下拉选择；表单填写、自动登录、验证码识别；页面导航、新标签页、关闭标签。
• 数据采集：提取文本、链接、表格、图片、HTML 源码。
• 多标签页管理：同时控制多个标签页。
• 页面截图：支持全页或区域截图。

安装与配置（快速上手）

安装扩展

• Chrome 商店：搜索 OpenClaw Browser Relay 并安装。
• 手动安装：
  1 2 3 4

  # 安装扩展 openclaw browser extension install # 获取扩展路径 openclaw browser extension path

  在 Chrome 中打开 chrome://extensions/ → 加载已解压的扩展。

配置连接

1. 打开扩展选项页（右键图标 → 选项）。
2. 填写 Gateway URL（默认 http://127.0.0.1:18792）和从 OpenClaw Gateway 控制台获取的 Token。
3. 点击 Save 保存。

连接浏览器

• 打开要操作的网页。
• 点击扩展图标 → Attach to Current Tab。
• 连接成功后，AI 即可控制该标签页。

优势与适用场景

优势

• 无需重复登录，直接使用已有账号状态。
• 轻量高效，不启动额外浏览器。
• 真实环境模拟，人类操作行为友好，减少反爬风险。
• AI 操作与人工操作并行，无缝切换。

适用场景

• 自动化办公：表单填写、数据录入、邮件发送。
• 数据采集：网页爬虫、新闻抓取、电商监控。
• 内容发布：社交媒体发帖、博客更新。
• 自动化测试：网页功能测试、回归测试。
• 日常任务：自动签到、消息提醒、价格监控。

局限性与注意事项

• 安全风险：AI 可访问所有标签页，建议仅在可信环境使用。
• 稳定性：依赖扩展与网络，偶有连接中断。
• 高级功能：截图、复杂元素定位需高级模型支持。
• 权限要求：需开启调试权限，部分网站可能拦截。

常见问题

• 连接失败

  • 检查 Gateway 是否已启动。
  • 确认端口与 Token 匹配。
  • 关闭防火墙或代理。

• AI 无法操作

  • 使用 Claude、Gemini 等高级模型。
  • 在提示词中加入 使用 openclaw 配置文件。