让 Agent 打开一个新浏览器,结果发现账号没登录。你还得手动再登一遍,有些网站甚至会触发验证码。
问题的根源是:默认的浏览器自动化模式,启动的是一个全新的 Chrome 实例。 干干净净,也什么都没有。
OpenClaw 的 Chrome DevTools MCP Attach Mode 解决的就是这个问题——不是新开浏览器,而是直接接管你已经在用的 Chrome。
🎯 这个功能能干什么?
简单说,就是让 OpenClaw "坐进"你当前打开的浏览器,在你已经登录的状态、已经打开的页面上继续工作。
适合这些场景:
你已经登录了某个后台,想让 AI 帮你操作,不想重新登录 你手动打开了一个复杂页面,想让 AI 继续往下操作 你需要调试网页,想让 AI 帮你分析 DOM、查看控制台 某些网站对新浏览器环境很敏感,容易触发风控
📋 使用前提
要使用 Attach Mode,需要满足以下条件:
- Chrome 和 OpenClaw Gateway 必须在同一台机器上
(不支持远程服务器、Docker、VPS) - 本机安装了 Google Chrome,版本 ≥ 144
- 在 Chrome 中启用远程调试
(下面有步骤) - Chrome 需要正在运行
,且至少有一个打开的标签页 - 首次连接时需要人工批准
attach 提示
请在微信客户端打开
⚙️ 配置步骤
第一步:编辑 OpenClaw 配置文件
配置文件路径:~/.openclaw/openclaw.json
如果文件不存在,创建它。写入以下内容:
{
"browser": {
"enabled": true,
"defaultProfile": "user"
}
}这样配置后,OpenClaw 默认会优先使用你当前的真实 Chrome。
更完整的配置:
{
"browser": {
"enabled": true,
"defaultProfile": "user",
"profiles": {
"user": {
"driver": "existing-session",
"attachOnly": true,
"color": "#00AA00"
}
}
}
}第二步:在 Chrome 中启用远程调试
打开 Google Chrome 在地址栏输入: chrome://inspect/#remote-debugging启用远程调试选项
这一步必须手动操作,OpenClaw 无法替你开启。
第三步:重启 OpenClaw Gateway
配置修改后需要重启才能生效:
openclaw gateway restart第四步:验证配置是否正确
依次运行以下命令检查:
# 检查整体状态
openclaw doctor
# 查看浏览器 profiles
openclaw browser profiles
# 测试能否列出当前 Chrome 的标签页
openclaw browser --browser-profile user tabs
# 检查 profile 状态
openclaw browser --browser-profile user status如果 tabs 命令能看到你当前 Chrome 打开的标签页,说明配置成功了。
第五步:在聊天中使用
配置完成后,在 OpenClaw 的聊天入口中这样调用:
请调用 browser tool,使用 profile="user",打开 https://xxx.com注意要明确写 profile="user",否则 OpenClaw 可能会使用默认的隔离浏览器。
✅ 什么时候该用 Attach Mode?
适合用:
你已经在 Chrome 中登录了 GitHub、Gmail、企业后台等网站 你手动打开了某些页面,想让 AI 继续操作 你需要 AI 帮你分析当前页面的结构、调试前端问题 你人在电脑前,可以处理首次连接的批准提示
不适合用:
OpenClaw 跑在远程服务器或 Docker 里(Attach Mode 是 host-only) 你想做完全无人值守的后台任务 你不想让 AI 接触你真实浏览器的登录态和 Cookie
❓ 常见问题
报错:No Chrome tabs found for profile="user"
原因:OpenClaw 看到了 Attach Mode 配置,但 Chrome 没有可附着的标签页。
解决:确保 Chrome 已经打开,且至少有一个标签页。
报错:attach-only profile 不可达
原因:Chrome 的远程调试没有启用,或者没有可用的调试目标。
解决:检查 chrome://inspect/#remote-debugging 是否已启用,然后重启 Chrome。
Doctor 警告 Chrome 版本过低
原因:Chrome 版本低于 144。
解决:升级 Chrome 到最新版本。
📌 一句话总结
Attach Mode 的本质:让 Agent 接管你已经准备好的真实浏览器上下文,而不是从零开始。
对于需要登录态、需要人工介入、需要调试排障的场景,这是浏览器自动化的关键升级。
夜雨聆风