101 lines
3.3 KiB
Markdown
101 lines
3.3 KiB
Markdown
# 浏览器工具配置
|
||
|
||
## 一、结论先行
|
||
|
||
可以使用如下配置（仅供参考）：
|
||
|
||
```json
|
||
{
|
||
"browser": {
|
||
|
||
// 是否启用 browser 工具模块
|
||
// 关闭后 OpenClaw 将不会提供浏览器自动化能力
|
||
"enabled": true,
|
||
|
||
// 调用远程 CDP（Chrome DevTools Protocol）接口时
|
||
// 单次请求的超时时间（毫秒）
|
||
"remoteCdpTimeoutMs": 1500,
|
||
|
||
// 与远程 CDP 建立 WebSocket 连接时的握手超时时间（毫秒）
|
||
"remoteCdpHandshakeTimeoutMs": 3000,
|
||
|
||
// 浏览器实例在 UI 或日志中的默认标识颜色
|
||
// 用于区分不同浏览器实例
|
||
"color": "#FF4500",
|
||
|
||
// OpenClaw 启动浏览器时使用的可执行文件路径
|
||
// 只有在 OpenClaw 托管浏览器（spawn browser）模式下才会使用
|
||
"executablePath": "/usr/bin/chromium-browser",
|
||
|
||
// 是否以无头模式启动浏览器
|
||
// true = 不显示浏览器窗口
|
||
// false = 显示浏览器 UI
|
||
"headless": false,
|
||
|
||
// 是否添加 --no-sandbox 启动参数
|
||
// 在 Docker / WSL / CI 环境中通常需要开启
|
||
"noSandbox": true,
|
||
|
||
// 是否只允许“附加到已有浏览器”
|
||
// true = OpenClaw 不会启动新浏览器，只能连接已有 CDP
|
||
// false = OpenClaw 可以自行启动浏览器
|
||
"attachOnly": false,
|
||
|
||
// 默认使用的浏览器 profile 名称
|
||
// 如果没有指定 profile，则使用这个
|
||
"defaultProfile": "chrome",
|
||
|
||
// 浏览器 profile 列表
|
||
// 每个 profile 代表一个可控制的浏览器实例
|
||
"profiles": {
|
||
|
||
// OpenClaw 默认自动化浏览器实例
|
||
"openclaw": {
|
||
|
||
// 该浏览器实例的 CDP 调试端口
|
||
// OpenClaw 会通过这个端口连接浏览器
|
||
"cdpPort": 18800,
|
||
|
||
// 该浏览器实例在 UI 或日志中的颜色标识
|
||
"color": "#FF4500"
|
||
},
|
||
|
||
// 第二个浏览器实例（例如工作环境浏览器）
|
||
"work": {
|
||
|
||
// 该实例的 CDP 调试端口
|
||
"cdpPort": 18801,
|
||
|
||
// UI / 日志中的颜色标识
|
||
"color": "#0066CC"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 二、实用场景
|
||
|
||
### 1.1 让 openclaw 控制个人浏览器实现自动化（使用个人用户态、登录态）
|
||
|
||
实现方案：
|
||
|
||
1. 插件安装
|
||
1. 使用 openclaw 官方 chrome 插件
|
||
1. 下载 openclaw 官方 chrome 插件 `openclaw browser extension install`
|
||
2. 查看插件安装路径 `openclaw browser extension path`
|
||
3. 打开 chrome 浏览器，访问 `chrome://extensions/`，开启开发者模式
|
||
4. 点击 `加载未打包的扩展程序`，选择 openclaw 插件安装路径
|
||
5. 中继器链接，使用中继器端口 `18792` 和 网关令牌 `token`，保存即可
|
||
2. 自行在 chrome 商店下载安装 OpenClaw Borwser Relay 插件
|
||
1. 登录谷歌插件商店 `https://chromewebstore.google.com/category/extensions`
|
||
2. 搜索 `OpenClaw Browser Relay`，选一个高分的就行，都不是官方的
|
||
3. 点击 `添加到 Chrome`，安装插件
|
||
2. 配置 openclaw 浏览器工具
|
||
1. 打开 openclaw 浏览器工具配置文件 `openclaw browser.json`
|
||
2. 配置 `cdpPort` 为 `18792`
|
||
3. 配置 `gatewayToken` 为 `token`
|
||
4. 保存配置文件
|
||
|
||
### 1.2让 openclaw 控制浏览器自行实现自动化（使用 openclaw 同一环境如 linux 浏览器）
|