乐于分享
好东西不私藏

OpenClaw 浏览器超时排查:从插件废弃到 chrome-mcp 的坑

OpenClaw 浏览器超时排查:从插件废弃到 chrome-mcp 的坑

我最近一个月在用OpenClaw Browser Relay Extension这个Chrome插件帮我做很多自动化的工作。

4月8日,我更新了OpenClaw,然后发现怎么点插件都无法正常启动。可能openclaw.json有变化吧,我检查了配置,改了几次,重启Gateway N次,还是不行。

直到我在 Reddit看到这篇帖子,读完才发现:原来官方从 2026 年 3 月底开始,已经不再依赖 Browser Relay Extension 了!

现在的推荐方式是直接用 openclaw browser 命令,底层走的是 Chrome DevTools MCP(Model Context Protocol)。 不需要任何Chrome扩展,直接attach到你已经运行的真实Chrome会话。

openclaw browser--browser-profile默认是openclaw(隔离、干净、独立)。如需使用用户的浏览器,需添加--browser-profile user参数。

使用前需要访问chrome://inspect/#remote-debugging开启远程调试支持:

配置完成后,我执行了这条命令:

浏览器会收到弹窗询问是否允许访问远程调试,点击”允许”后,命令行的指令过一会儿会出现超时错误。

最终根因总结

macOS 上 OpenClaw Chrome MCP(existing-session / chrome-mcp)在用户点击”允许”后,MCP 持久连接建立失败,导致 browser open 命令在 Gateway 侧超时。

这个问题在OpenClaw 的 GitHub Issue上有讨论,我找到了一个相关的 Issue(目前仍处于Open状态)

First connection attempt fails with gateway timeout, second attempt succeeds. Suspect chrome-mcp attach latency.

https://github.com/openclaw/openclaw/issues/45889

这是当前版本的已知局限/bug:

  • • 非配置错误
  • • 非扩展残留
  • •非Gateway问题

不是配置或者操作的问题。

要等版本修复吗?那得等到什么时候!我的自动化啊~~~


解决方案

刚刚提到的 Issue 中就有网友提到:运行2次同样的命令,第二次就会成功(你别说,你真别说,我也无比无语),我试了试,真的可以:

openclaw browser --browser-profile user open https://www.crazyphper.com || true openclaw browser --browser-profile user open https://www.crazyphper.com

第二次成功后,后续的openclaw browser --browser-profile user open XXX就都正常了。

PS:日常一些不需要现有浏览器登录态时,直接用默认profile:

openclaw browser

启动速度快、稳定性高、不干扰日常浏览。缺点是需要重新登录某些网站。适合爬虫、自动化测试等场景。

最后

踩坑是成长的代价,分享是成长的价值。

这次排查让我明白,技术的坑往往不是技术问题,是信息问题。如果官方文档早点说明Browser Relay Extension已废弃,如果--browser-profile user的文档里注明首次连接可能超时,至少能少折腾点,Peter还是太理想主义了。


我最近正在打造一个分享全球远程工作机会,专为远程工作者提供成长的频道。想持续收到最新远程工作机会和Freelancer干货?快来订阅看看!