跳转至

隔离和浏览器选择

隔离保证

  • 专用用户数据目录:绝不会触碰你的个人浏览器配置文件。
  • 专用端口:避免使用 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 或 $XDG_CACHE_HOME/ms-playwright 下由 Playwright 管理的 Chromium(当 XDG_CACHE_HOME 未设置或为空时,默认为 ~/.cache/ms-playwright)。缓存路径 使用 Playwright 的环境变量优先级,包括 npm 配置别名; 相对路径从 INIT_CWD 或当前工作目录解析。 PLAYWRIGHT_BROWSERS_PATH=0 会选择已安装的 Playwright 包的 .local-browsers 目录。
  • Windows:检查常见安装位置。

控制 API(可选)

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

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw