agent-browser 并行串台的根治:命名会话 + 显式 connect
同一台 Mac 上并行跑两个浏览器自动化项目,很快会撞上一件怪事:A 项目刚发出的命令,作用到了 B 项目的页面上——我们这边点了没反应,对方窗口里莫名出现我们想打开的地址。本文记录这次排查与落地:用「命名会话 + 显式 connect」把两个项目的控制通道彻底拆开。
一、现象
项目 A 用 CDP 9222 驱动一只 Chrome(数据目录 ~/openclaw-cdp),项目 B 用 9223 驱动另一只(~/hw-grow-cdp)。两边浏览器 profile 本来就是隔离的,但 get url 偶尔返回对方页面,点击也会打到对方浏览器上。
二、根因:三条叠加
1)daemon 按 --session 分片,默认匿名会话 default 是全机器共享的。两个项目都用 default,就等于共用一个 daemon。
2)--cdp 只在会话首次连接时生效,之后被忽略。第二个项目再传 --cdp 9223,命令仍然打到会话当前绑定的那台浏览器。
3)连接失效时 agent-browser 会 auto-launch,并回退到别的端口。实测 --cdp 9222 open 报 Auto-launch failed ... 9223,直接连到了另一个项目的浏览器。
三、方案:命名会话 + 显式 connect
每个项目一个专属会话,连接动作从含糊的 --cdp 换成明确的 connect——语义是「连到这台已存在的 Chrome」,不会触发 auto-launch:
agent-browser --session proj-a connect 9222 agent-browser --session proj-b connect 9223
把这两条封进项目内的薄包装层 tools/ab.sh,业务侧只写 bash tools/ab.sh open <url>,避免几十处调用散改漏改。包装层还要额外做两件事:
· 清代理环境变量。daemon 会继承 http_proxy / https_proxy,全局代理开着时连不上 127.0.0.1 的 CDP。
· 连接缓存。用「端口 + 浏览器实例 UUID」记录当前绑定,Chrome 重启(UUID 变化)或 daemon 重建(命令报连接错)时自动重连一次,正常路径只多一次本地 curl。
核心片段:
uuid=$(curl -s http://127.0.0.1:$PORT/json/version | python3 -c 'import json,sys;print(json.load(sys.stdin)["webSocketDebuggerUrl"].rstrip("/").split("/")[-1])')
[ "$(cat $BIND)" = "$uuid" ] || agent-browser --session $SESSION connect $PORT
agent-browser --session $SESSION "$@"
四、验证
让项目 B 打开一个独有页面,再分别请求两个端口的 /json/list:命中数分别是 1 和 0,说明导航只落在自己的实例上。把端口故意写成 9333,命令以「CDP 不可用」直接退出,不再 auto-launch 到别人的端口。
五、另外两个坑
· 不要 pkill agent-browser-darwin。daemon 跨项目共享,杀进程会连别人的任务一起杀;隔离靠 session,不靠杀进程。
· eval 必须传裸表达式。document.title 可以,() => document.title 会静默返回 {}。
结论
多实例并行的隔离,靠的不是端口号本身,而是把「控制通道(session)」和「连接动作(connect)」两件事都显式化。做到这两点,两个项目各跑各的浏览器,互不串台;隔天再回头看,这套写法也能直接复用到第三个、第四个并行项目上。
- 点赞
- 收藏
- 关注作者
评论(0)