隔离和浏览器选择

隔离保证¶

• 专用用户数据目录：绝不会触碰你的个人浏览器配置文件。
• 专用端口：避免使用 9222，以防止与开发工作流发生冲突。
• 确定性的标签页控制：tabs 首先返回 suggestedTargetId，然后返回稳定的 tabId 句柄，例如 t1、可选标签，以及原始 targetId。 代理应复用 suggestedTargetId；原始 ID 仍可用于调试和兼容性。配置了 driver: "extension" 的配置文件还可以返回一个运行时作用域的数值型 webExtensionTabId，用于 Chrome WebExtensions API 调用。对于其他驱动程序，它会省略，并且不得在 OpenClaw 浏览器操作中替换 suggestedTargetId 或 tabId。

浏览器选择¶

在本地启动时，OpenClaw 会选择第一个可用的：

1. Chrome
2. Brave
3. Edge
4. Chromium
5. Chrome Canary

你可以通过 browser.executablePath 进行覆盖。

平台：

• macOS：检查 /Applications 和 ~/Applications。
• Linux：检查 /usr/bin、/snap/bin、/opt/google、/opt/brave.com、/usr/lib/chromium 和 /usr/lib/chromium-browser 下常见的 Chrome/Brave/Edge/Chromium 位置，以及 PLAYWRIGHT_BROWSERS_PATH 或 ~/.cache/ms-playwright 下由 Playwright 管理的 Chromium。
• Windows：检查常见安装位置。

控制 API（可选）¶

用于脚本编写和调试，Gateway 会暴露一个小型的 仅回环 HTTP 控制 API，以及一个对应的 openclaw browser CLI（快照、引用、等待唤醒、JSON 输出、调试工作流）。请参阅 浏览器控制 API 获取完整参考。