用途:控制用户现有的真实 Chrome 配置,尤其用于依赖登录态的工作和实时 UI 验证。登录密集站点常依赖真实配置的 Cookie、SSO、设备信任与扩展。
路由优先级:当前会话中可调用的 Codex Chrome 或 Chrome [Internal] 插件优先(仅装在磁盘上不算);否则用 OpenClaw 扩展支持的 mcporter 路由;直连 DevTools 仅作明确最后回退。禁止用隔离 Chrome、Codex 应用内浏览器、Playwright、Puppeteer、AppleScript、osascript、通用 GUI 脚本或 macOS open 替代,除非用户明确要求隔离或新浏览器。Peekaboo 仅用于 Chrome 或扩展设置及可见提示。
用法要点:mcporter 的 MCP 调用是面向代理的控制接口,OpenClaw 扩展是其底层传输。在规范全局 Chrome 服务器定义上设 chromeDevtoolsRelay: "require" 强制仅走中继,并显式声明调用方策略:MCPORTER_CHROME_DEVTOOLS_RELAY_POLICY=require mcporter call chrome-devtools.<tool>。典型流程为 list_pages、select_page、take_snapshot、click、fill、evaluate_script,快照 UID 在导航或重渲染后失效需重新获取。--args 只接受内联 JSON,不读 @file;命名参数可用 url=@/tmp/target-url.txt 形式,登录 URL 等凭据等价物应写入 0600 文件按引用传递。
设置与修复:先运行 openclaw browser extension install 再 Load unpacked;用 openclaw browser extension status --json 验证,需无问题且 manualSetupRequired: false。配对或改路由后先 mcporter daemon stop 再重跑中继证明。发现超时可在规范配置 env 中设 MCPORTER_CHROME_DEVTOOLS_RELAY_TIMEOUT_MS 为 20000,旧客户端可加 --timeout 300000。
限制:中继可能中途不再暴露标签页,空列表表示无合格标签而非浏览器消失;点击可能返回成功却无效果,需用 press_key 与截图确认焦点。若自动化不可用,应报告验证缺口,不要静默切换到被禁或隔离工具。远程 Gateway 配对不创建本地中继。