chrome-relay-browser
通过 Chrome Extension relay 控制已 attach 的浏览器标签页。
前置条件
- 0. 配置 openclaw.json（确保 browser 部分已配置）：
CODEBLOCK0
- 1. 安装 Chrome 扩展：
openclaw browser extension install
openclaw browser extension path # 获取安装路径
然后在 Chrome 中加载：打开
chrome://extensions，开启开发者模式，加载上述路径
- 2. 配置扩展（安装后需配置一次）：
- 点击扩展图标 → 设置
- Relay port: 从
~/.openclaw/secrets/browser-relay.env 读取
RELAY_PORT
- Gateway token: 从
~/.openclaw/secrets/browser-relay.env 读取 INLINECODE4
- 3. Attach 标签页：
- 在 Chrome 打开任意页面
- 点击扩展图标 attach
使用方法
运行 scripts/ctl.js 控制浏览器：
CODEBLOCK2
可用命令
| 命令 | 说明 | 示例 |
|---|
| INLINECODE5 | 打开 URL | INLINECODE6 |
| INLINECODE7 |
截图 |
node ctl.js screenshot /tmp/abc.png |
|
title | 获取页面标题 |
node ctl.js title |
|
url | 获取当前 URL |
node ctl.js url |
|
evaluate <js> | 执行 JS |
node ctl.js evaluate "document.title" |
配置
Token 和 Port 存储在 ~/.openclaw/secrets/browser-relay.env，脚本自动读取：
- -
RELAY_TOKEN - Gateway token - INLINECODE17 - Relay 端口号
故障排除
- - Unauthorized: 检查扩展设置的 Gateway token 是否与 secrets 中的 RELAYTOKEN 一致
- No tabs: 提醒用户先在 Chrome 中 attach 标签页
- Connection refused: 重启 Gateway 或检查 RELAYPORT 配置
chrome-relay-browser
通过 Chrome 扩展中继控制已附加的浏览器标签页。
前置条件
- 0. 配置 openclaw.json（确保已配置 browser 部分）：
json
browser: {
enabled: true,
defaultProfile: chrome-relay,
attachOnly: true
}
- 1. 安装 Chrome 扩展：
bash
openclaw browser extension install
openclaw browser extension path # 获取安装路径
然后在 Chrome 中加载：打开 chrome://extensions，开启开发者模式，加载上述路径
- 2. 配置扩展（安装后需配置一次）：
- 点击扩展图标 → 设置
- Relay 端口：从 ~/.openclaw/secrets/browser-relay.env 读取 RELAY_PORT
- 网关令牌：从 ~/.openclaw/secrets/browser-relay.env 读取 RELAY_TOKEN
- 3. 附加标签页：
- 在 Chrome 中打开任意页面
- 点击扩展图标进行附加
使用方法
运行 scripts/ctl.js 控制浏览器：
bash
cd ~/.openclaw/workspace/skills/chrome-relay-browser/scripts
node ctl.js <命令> [参数]
可用命令
| 命令 | 说明 | 示例 |
|---|
| navigate <url> | 打开 URL | node ctl.js navigate https://baidu.com |
| screenshot [路径] |
截图 | node ctl.js screenshot /tmp/abc.png |
| title | 获取页面标题 | node ctl.js title |
| url | 获取当前 URL | node ctl.js url |
| evaluate
| 执行 JS | node ctl.js evaluate document.title |
配置
令牌和端口存储在 ~/.openclaw/secrets/browser-relay.env，脚本自动读取：
- - RELAYTOKEN - 网关令牌
- RELAYPORT - 中继端口号
故障排除
- - 未授权：检查扩展设置的网关令牌是否与 secrets 中的 RELAYTOKEN 一致
- 无标签页：提醒用户先在 Chrome 中附加标签页
- 连接被拒绝：重启网关或检查 RELAYPORT 配置
