隔离和浏览器选择

隔离保证

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

浏览器选择

在本地启动时，OpenClaw 会按以下顺序选择第一个可用的浏览器：

1. Chrome
2. Brave
3. 边缘
4. Chromium
5. Chrome 金丝雀

你可以通过 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-在PLAYWRIGHT_BROWSERS_PATH或$XDG_CACHE_HOME/ms-playwright下管理Chromium（当XDG_CACHE_HOME未设置或为空时，默认为~/.cache/ms-playwright）。缓存路径使用Playwright的环境优先级，包括npm配置别名；相对路径从 INIT_CWD 或当前工作目录解析。 PLAYWRIGHT_BROWSERS_PATH=0 选择已安装的 Playwright 软件包的 .local-browsers 目录。
• Windows：检查常见安装位置。

Control API（可选）

用于脚本编写和调试时，Gateway 提供了一个小型的仅回环可访问的 HTTP 控制 API，以及对应的 openclaw browser CLI（快照、引用、等待增强、JSON 输出、调试工作流）。完整参考请见 浏览器控制 API。