OpenClaw 的配置文件默认路径是:
~/.openclaw/openclaw.json
如果这个文件不存在,OpenClaw 会使用默认配置。
如果你只是想让 OpenClaw 默认优先使用真实 Chrome,可以把配置文件写成这样:
{
"browser": {
"enabled": true,
"defaultProfile": "user"
}
}
省略 profile 时会走 browser.defaultProfile,而官方说明它默认通常是 openclaw;改成 "user" 后,就会默认走真实 Chrome 模式。
如果你想明确写出 user profile,可以用这一版:
{
"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 读取的。
打开本机 Google Chrome。
至少打开一个标签页。
到下面这个地址启用 remote debugging:
chrome://inspect/#remote-debugging
官方 Doctor 页面明确把这一步列为真实 Chrome 模式的前置要求。
openclaw doctor
Doctor 会检查:
Chrome 是否安装在同一台主机上
版本是否过低
是否需要启用 chrome://inspect/#remote-debugging
是否还残留旧的扩展式配置并自动规范迁移提示。
openclaw browser profiles
browser CLI 文档明确说明,profile 是命名的浏览器路由配置;内置 profile 包括 openclaw 和 user。
openclaw browser --browser-profile user tabs
如果能看到当前本机 Chrome 的标签页,说明基本打通。这个命令是官方 CLI 文档的标准用法。
openclaw browser --browser-profile user status
这是验证 profile 是否可达的常用方法,CLI 文档中 --browser-profile <name> 就是用来显式指定 profile 的。
如果你是在 Telegram、MacBot 或其他 OpenClaw 聊天入口里调用,建议写得明确一点:
请调用 browser tool,使用 profile="user",打开 https://space.bilibili.com/3493277319825652
原因很简单:官方说明当 profile 被省略时,会使用 browser.defaultProfile;如果你没有改默认值,它大概率还是走隔离浏览器 openclaw,而不是真实 Chrome。
