虾折腾大赛+OpenClaw重磅更新:浏览器自动化终极方案:龙虾自动接管Chrome浏览器,无需重复登录账号
AI超元域
2026年03月17日 19:10

配置文件位置

OpenClaw 的配置文件默认路径是:

代码块
Shell
自动换行
复制代码
~/.openclaw/openclaw.json
复制成功

如果这个文件不存在,OpenClaw 会使用默认配置。


最简配置方案

如果你只是想让 OpenClaw 默认优先使用真实 Chrome,可以把配置文件写成这样:

代码块
JSON
自动换行
复制代码
{
  "browser": {
    "enabled": true,
    "defaultProfile": "user"
  }
}
复制成功

省略 profile 时会走 browser.defaultProfile,而官方说明它默认通常是 openclaw;改成 "user" 后,就会默认走真实 Chrome 模式。


完整一点的配置方案

如果你想明确写出 user profile,可以用这一版:

代码块
JSON
自动换行
复制代码
{
  "browser": {
    "enabled": true,
    "defaultProfile": "user",
    "profiles": {
      "user": {
        "driver": "existing-session",
        "attachOnly": true,
        "color": "#00AA00"
      }
    }
  }
}
复制成功

Doctor 文档明确说明,旧的扩展路径迁移后,browser.profiles.*.driver: "extension" 会被规范成 "existing-session";这正是 host-local Chrome MCP attach 模式使用的驱动类型。


改完配置后怎么生效

改完 ~/.openclaw/openclaw.json 后,重启 OpenClaw Gateway,再进行测试。配置文件本身是 Gateway 读取的。


Chrome 侧需要做什么

  1. 打开本机 Google Chrome。

  2. 至少打开一个标签页。

  3. 到下面这个地址启用 remote debugging:

代码块
PlainText
自动换行
复制代码
chrome://inspect/#remote-debugging
复制成功

官方 Doctor 页面明确把这一步列为真实 Chrome 模式的前置要求。


推荐的检查顺序

1)先跑 Doctor

代码块
Shell
自动换行
复制代码
openclaw doctor
复制成功

Doctor 会检查:

  • Chrome 是否安装在同一台主机上

  • 版本是否过低

  • 是否需要启用 chrome://inspect/#remote-debugging

  • 是否还残留旧的扩展式配置并自动规范迁移提示。

2)查看浏览器 profiles

代码块
Shell
自动换行
复制代码
openclaw browser profiles
复制成功

browser CLI 文档明确说明,profile 是命名的浏览器路由配置;内置 profile 包括 openclaw 和 user。

3)测试真实 Chrome 是否能列出标签页

代码块
Shell
自动换行
复制代码
openclaw browser --browser-profile user tabs
复制成功

如果能看到当前本机 Chrome 的标签页,说明基本打通。这个命令是官方 CLI 文档的标准用法。

4)再测试状态

代码块
Shell
自动换行
复制代码
openclaw browser --browser-profile user status
复制成功

这是验证 profile 是否可达的常用方法,CLI 文档中 --browser-profile <name> 就是用来显式指定 profile 的。


在聊天里怎么调用

如果你是在 Telegram、MacBot 或其他 OpenClaw 聊天入口里调用,建议写得明确一点:

代码块
PlainText
自动换行
复制代码
请调用 browser tool,使用 profile="user",打开 https://space.bilibili.com/3493277319825652
复制成功

原因很简单:官方说明当 profile 被省略时,会使用 browser.defaultProfile;如果你没有改默认值,它大概率还是走隔离浏览器 openclaw,而不是真实 Chrome。