Browser Config - 浏览器配置技能
描述
配置和管理 OpenClaw-CN 浏览器模式。支持两种浏览器模式：
- openclaw - OpenClaw 独立管理的浏览器（推荐，稳定）
- chrome - Chrome 扩展中继模式（需要扩展连接）
触发词
- 配置浏览器
- 切换浏览器模式
- 浏览器打不开
- 浏览器配置
- 设置浏览器
两种模式对比
| 特性 | openclaw 模式 | chrome 模式 |
|---|---|---|
| 依赖扩展 | ❌ 不需要 | ✅ 需要 OpenClaw Browser Relay 扩展 |
| 稳定性 | ⭐⭐⭐⭐⭐ 高 | ⭐⭐⭐ 中（依赖扩展连接） |
| 登录状态 | 独立保存 | 使用 Chrome 现有登录 |
| 适用场景 | 长期稳定使用、需要登录的网站 | 临时使用、想共用 Chrome 书签 |
| 启动命令 | openclaw-cn browser --browser-profile openclaw start | openclaw-cn browser --browser-profile chrome start |
配置方法
切换到 openclaw 模式（推荐）
编辑 C:\Users\Administrator\.openclaw\openclaw.json，添加或修改：
{
"browser": {
"enabled": true,
"defaultProfile": "openclaw",
"headless": false,
"noSandbox": false,
"attachOnly": false,
"profiles": {
"openclaw": {
"cdpPort": 18800,
"color": "#FF4500"
}
}
}
}
然后重启网关：
openclaw-cn gateway restart
启动浏览器：
openclaw-cn browser --browser-profile openclaw start
切换到 chrome 模式
编辑 C:\Users\Administrator\.openclaw\openclaw.json：
{
"browser": {
"enabled": true,
"defaultProfile": "chrome",
"headless": false,
"noSandbox": false,
"attachOnly": false
}
}
重启网关后，需要：
- 打开 Chrome 浏览器
- 点击 OpenClaw Browser Relay 扩展图标
- 确保扩展连接到当前标签页（图标显示 ON）
常见问题排查
问题 1：浏览器服务连不上
错误信息： Can't reach the OpenClaw-CN browser control service
解决方案：
- 检查浏览器状态：
openclaw-cn browser --browser-profile <profile名> status - 如果
运行中：false，启动它：openclaw-cn browser --browser-profile <profile名> start - 如果是 chrome 模式，确保扩展已连接
问题 2：chrome 扩展模式一直连不上
原因： 扩展中继服务通信问题
解决方案： 改回 openclaw 模式（更稳定）
问题 3：网关重启后浏览器没了
解决方案： 重新运行启动命令：
openclaw-cn browser --browser-profile openclaw start
使用示例
打开网页
openclaw-cn browser --browser-profile openclaw open https://www.xiaohongshu.com
查看状态
openclaw-cn browser --browser-profile openclaw status
截图
通过 browser 工具调用：
browser: screenshot, targetId=<标签页 ID>
注意事项
- 登录状态保存 - openclaw 模式的登录数据保存在
C:\Users\Administrator\.openclaw\browser\openclaw\user-data - 不要混用模式 - 频繁切换模式可能导致登录状态丢失
- 推荐 openclaw 模式 - 更稳定，不依赖扩展，适合长期使用
- 发小红书/微博等 - 登录一次后会话会保持，不需要每次都登录
配置文件位置
- 主配置：
C:\Users\Administrator\.openclaw\openclaw.json - 浏览器数据：
C:\Users\Administrator\.openclaw\browser\openclaw\user-data - 网关日志：
C:\Users\Administrator\.openclaw\logs\gateway.log