浏览器配置文件

• openclaw：托管的隔离浏览器（无需扩展）。
• user：内置的 Chrome DevTools MCP 附加配置文件，用于你的真实已登录 Chrome 会话。OpenClaw 首次附加时，Chrome 会显示一个阻塞式的“允许远程调试？”提示，因此必须有人在场。
• chrome：内置的 Chrome 扩展配置文件，用于你的真实已登录 Chrome 会话。即使桌边无人，也可以从手机操作，因为它通过 OpenClaw 浏览器扩展而不是远程调试端口来驱动标签页，因此不会出现“允许远程调试？”提示。

对于代理浏览器工具调用：

• 默认：使用隔离的 openclaw 浏览器。
• 当现有已登录会话很重要且用户不在电脑前时（Telegram、WhatsApp 等），优先使用 profile="chrome"（扩展）。
• 当现有已登录会话很重要且用户在电脑前可以批准附加提示时，优先使用 profile="user"（Chrome MCP）。
• 当你想要特定浏览器模式时，profile 是显式覆盖选项。

如果你希望默认使用托管模式，请设置 browser.defaultProfile: "openclaw"。

控制界面中的浏览器面板¶

浏览器面板跟随当前会话最近一次成功的浏览器标签页，包括其配置文件以及主机或节点。打开浏览器预览卡片会选中该卡片的浏览器和标签页。这不会改变 browser.defaultProfile 或其他会话的选择。如果没有会话浏览器目标，面板将使用配置的默认路由。

聊天侧边面板仅显示当前会话的标签页：其代理或面板打开的标签页，以及其对话使用过的标签页。其他会话的标签页以及在 OpenClaw 之外打开的标签页保持隐藏。聊天会话之外的浏览器坞站列出所有标签页。从会话面板打开的标签页属于该会话，并遵循现有的会话标签页清理规则：当会话被重置或删除时，这些标签页会关闭，空闲和每会话限制由 browser.tabCleanup 控制。在所有权规则存在之前从面板打开的标签页没有记录的会话，因此它们保持打开，但仅出现在聊天会话之外的浏览器坞站中。

面板会在页面重绘时实时流式传输活动标签页。对于节点路由浏览器、Chrome MCP 现有会话配置文件、缺少 Playwright 或流连接失败的情况，它会回退到截图。导航规则适用于流：导航到被阻止的地址会停止流并清除视图。

已建立的流断开后，面板会刷新其截图，并在短暂延迟后自动重试流。注释和检查会保留其捕获的图像，直到你返回交互模式。

当 OpenClaw 能够识别浏览器路由时，预览卡片仅对 HTTP(S) 页面 URL 显示。空白或内部页面仍作为普通工具结果。没有页面 URL 的标签页操作仍会更新浏览器面板的选择。沙盒浏览器结果对代理仍然可用，但不会打开主机浏览器预览。在同一个聊天活动组中重复打开同一页面，对于相同的浏览器配置文件以及主机或节点，会共享一个预览卡片。该卡片打开最近使用的标签页；不同的页面 URL 或浏览器路由保持分离。可能在工具元数据中被缩短的长 URL 保留单独的标签页卡片，以避免隐藏不同的页面。展开工具活动以检查每个原始调用和结果。

如果列出的标签页无法访问，面板会说明是导航规则阻止了它，还是其地址无法验证。选择另一个标签页，输入允许的地址，或在临时查找失败后刷新。被阻止的 URL 保持隐藏；显示标签页标题并不授予对其内容的访问权限。

跟随历史标签页绝不会启动已停止的托管浏览器：全新启动不可能包含该标签页。面板改为显示启动浏览器，当目标不可用时，预览卡片保留其标题和 URL 但没有缩略图。点击启动浏览器以启动浏览器并显示其当前标签页。

对于 macOS 和 Linux 上的本地 attachOnly CDP 配置文件，当 OpenClaw 能够验证所附加的浏览器正在以可见窗口运行时，直接预览截图会保留活动 Chrome 标签页。无头浏览器和无法验证模式的浏览器保持现有的激活行为，以便截图保持可靠。显式的标签页聚焦操作仍会激活请求的标签页。