架构解析

Browser Relay 由三个核心组件构成：

安装与配置

 
官方教程: docs.openclaw.ai/tools/chrom…

1. 安装 Chrome 扩展

# 安装扩展到稳定路径
openclaw browser extension install


# 查看扩展目录路径
openclaw browser extension path

然后将这个文件夹下载下来：

1. 打开其他电脑上的Chrome → chrome://extensions

2. 启用"开发者模式"

3. 点击"加载已解压的扩展程序"

4. 选择上面命令输出的目录

5. 将扩展图标固定到工具栏

2. 配置文件详解

在 ~/.openclaw/openclaw.json 中：

我这块因为用的是SSH隧道的方案,所以直接采用的默认的配置,只设置了几个参数,如下图!

3.插件配置

这里需要用命令创建SSH隧道,因为我安装openclaw时用的默认配置,都是监听的127.0.0.1,外网是无法访问这些端口的.可以在电脑上运行以下命令建立隧道! 

不过这个需要一直保持cmd窗口开启,你可以让AI给你写一个后台启动的方案!

ssh -L 18792:127.0.0.1:18792 root@服务器IP

徽章状态说明

常见问题

使用过程中遇到了下面几个问题,可能2026.1.29 版本的浏览器插件已经更新修复了,若没有修复,你可以用我优化后的插件.我的这个需要在你工作区tools.md中强调一下!

PS: 其实只要能和AI对话,这些都能让他给你慢慢排查!

问题 1："tab not found" 错误

现象：tabs 命令能正确列出标签页，但 screenshot 或 snapshot 报错 Error: tab not found

环境示例：

• Gateway 运行在云服务器 (Linux)

• Chrome + 扩展运行在 Windows 主机

• 中继可达（cdpReady: true）

{
  "running": true,
  "cdpReady": false,
  "cdpHttp": true,
  "tabs": [...]
}

{
  "agents": {
    "defaults": {
      "sandbox": {
        "browser": {
          "allowHostControl": true
        }
      }
    }
  }
}