OpenClaw Browser Relay
OpenClaw Browser Relay 是 OpenClaw AI 智能体框架中的一项独特功能， 它允许 AI 直接控制你现有的 Chrome 浏览器标签页，而不是启动一个全新的独立浏览器实例。
简单来说，它就是连接 AI 和你日常浏览器 的“桥梁”。通过安装一个 Chrome 扩展程序， 你可以像聊天一样给 AI 下达指令（例如 “帮我把这个表单填了”， “提取当前页面的数据”），AI 就会自动在你的浏览器上完成点击、输入、滚动等操作。
🚀 核心优势
🔐 无缝集成 & 会话保持
- ✅ 保留登录状态 – 直接操作已登录网站（企业后台、Gmail、飞书等），无需重新登录。
- 🌍 复用真实环境 – 使用你的代理、已安装插件、Cookie，模拟真实用户操作。
- 🤝 实时人机协作 – 你和 AI 可同时查看同一页面，随时监督或接管控制。
⚙️ 工作原理简析
- 🔌 Chrome 扩展 – 作为“遥控器”执行 DOM 操作
- 📡 本地中继服务器 – 轻量服务中转通信
- 🧠 OpenClaw 网关 & AI 智能体 – 自然语言 → 浏览器操作命令
🆚 对比：Extension Relay vs Managed Browser
| 模式 | Extension Relay (扩展中继) | Managed Browser (托管浏览器) |
|---|---|---|
| 运行方式 | 控制你现有的 Chrome 标签页 | 启动全新独立的 Chromium 窗口 |
| 登录状态 | ✅ 完美复用，无需重新登录 | ❌ 需要重新登录账号 |
| 隐私安全 | ⚠️ AI 可访问你附加的标签页 | ✅ 完全隔离，不影响个人数据 |
| 适用场景 | 处理私人仪表盘、内部系统、临时任务 | 自动化爬虫、无人值守挂机、高隐私需求 |
💡 总结建议：日常让 AI 协助填写表单、内部数据查询 → 选 Browser Relay；
长期无人值守或极度注重隐私隔离 → 使用 Managed Browser。
⚙️ OpenClaw Browser Relay 配置指南
遵循以下四个步骤，即可将 AI 连接至您的 Chrome 环境，享受保留登录态的智能自动化。
🔧 安装与加载浏览器扩展
在终端中执行命令，将扩展安装至本地：
获取扩展目录路径：
在 Chrome 中加载扩展：
- 打开 chrome://extensions/
- 开启右上角 “开发者模式”
- 点击 “加载已解压的扩展程序”，选择上一步输出的目录
- 成功后，建议将 OpenClaw 小螃蟹图标固定到工具栏
🔑 获取 Gateway Token
Token 是扩展连接本地网关的「钥匙」，根据您的操作系统使用对应命令获取：
cat ~/.openclaw/openclaw.json | grep '"token"' | grep -v "apiKey"
(Get-Content "$HOME\.openclaw\openclaw.json" | ConvertFrom-Json).gateway.auth.token
复制输出的 Token 字符串（注意去掉首尾多余空格）。
⚙️ 配置扩展并建立连接
点击浏览器工具栏上的 OpenClaw 扩展图标，进入配置页面：
- Port (端口)：默认填入 18792（若自定义过网关端口，按实际填写）
- Gateway token：粘贴步骤2复制的 Token
- 点击 Save 保存
🎯 绑定标签页并开始使用
打开你想要自动化的网页（例如后台系统、社交媒体），点击工具栏 OpenClaw 图标，当图标徽章显示 “ON” 时，代表该标签页已交由 AI 控制。
此时，就可以在命令行或对话中对 OpenClaw 直接下达指令：
“帮我搜索 Pocket3 并进入商品详情页”
✨ AI 将自动点击、输入、滚动，完全复用你现有的登录态 (Cookie/Session)。
Browser Relay 的最大优势在于可直接复用当前浏览器的登录凭证，无需AI重新登录，适合私有仪表盘、企业后台等需要真人登录态的场景。
🧩 架构补充：三大组件如何联动
注: 所有通信均在本地完成，扩展与中继之间使用加密 Token 确保安全性。中继服务由 OpenClaw 自动启动，无需手动干预。