浏览器(OpenClaw 管理)
OpenClaw 可以运行一个专用 Chrome/Brave/Edge/Chromium 配置文件,由智能体控制。它通过 Gateway 内部的一个小型本地控制服务运行(仅限回环),并且与您的个人浏览器隔离。
- 可以将其视为一个独立的、智能体专用的浏览器。
openclaw配置文件永远不会接触您的个人浏览器配置文件。 - 智能体在此隔离通道中打开标签页、阅读页面、点击和输入。
- 内置的
user配置文件则通过 Chrome DevTools MCP 附加到您实际已登录的 Chrome 会话。
本页是索引页。浏览器文档分为九个页面,每个页面对应一类读者任务。请打开与您的任务匹配的页面。
| 页面 | 适用场景 |
|---|---|
| 浏览器设置 | 您首次启用浏览器,或工具缺失时。 |
| 浏览器配置文件 | 您在受管浏览器与已登录的 Chrome 会话之间做选择时。 |
| 浏览器配置 | 您需要配置块、端口、SSRF 策略或不同的 Chromium 二进制文件时。 |
| 远程与托管浏览器 | 浏览器位于另一台机器上,或您使用托管的 CDP 提供商时。 |
| 浏览器安全 | 您正在审查控制 API 认证或处理远程 CDP 令牌时。 |
| 多配置文件与现有会话附加 | 您需要额外的命名配置文件,或希望智能体在您已登录的浏览器中运行时。 |
| 隔离与浏览器选择 | 您需要隔离保证、二进制文件搜索顺序或控制 API 时。 |
| 浏览器故障排查 | 浏览器无法启动,或导航被阻止时。 |
| 浏览器智能体工具 | 您需要浏览器工具操作以及智能体传递的参数时。 |
您将获得的内容¶
- 一个名为 openclaw 的独立浏览器配置文件(默认橙色强调色)。
- 确定性的标签页控制(列出/打开/聚焦/关闭)。
- 智能体操作(点击/输入/拖拽/选择)、快照、截图、PDF。
- 基于可读页面文本进行问答,无需返回完整快照。
- 基于 Playwright 的配置文件将直接附件导航保存在受管下载目录下,并在最终 URL 策略验证后返回
{ url, suggestedFilename, path }元数据。 - 当操作立即启动一个或多个下载时,基于 Playwright 的智能体操作会返回一个
downloads数组,其中包含相同的受管元数据。 - 一个内置的
browser-automation技能,在浏览器插件启用时,教导智能体快照、稳定标签页、过期引用和手动拦截的恢复循环。 - 可选的多配置文件支持(
openclaw、work、remote等)。
此浏览器不是您的日常浏览器。它是用于智能体自动化和验证的安全、隔离环境。
在 macOS 上,您可以显式地将 cookie 从 Chrome 系列系统配置文件复制到单独的受管配置文件中。受管浏览器仍使用自己的用户数据目录。仅复制选定的 cookie,本地存储和 IndexedDB 保留在原处。有关导入命令和限制,请参阅配置文件或 openclaw browser CLI 参考。
各章节迁移位置¶
上一单页版本中的每个章节标题都在此处保留其锚点,因此现有链接(如 /tools/browser#custom-chrome-mcp-launch)仍然可以解析。每个条目都指向现在承载相应内容的页面。
- 快速开始
- 插件控制
- 智能体指南
- 缺少浏览器命令或工具
- 配置文件:
openclaw、user、chrome - Control UI 中的浏览器面板
- 配置
- 标签页清理归属
- 截图视觉(纯文本模型支持)
- 端口与可达性
- SSRF 策略
- 配置文件行为
- 使用 Brave 或其他基于 Chromium 的浏览器
- macOS 可执行文件路径选项卡
- Windows 可执行文件路径选项卡
- Linux 可执行文件路径选项卡
- 本地控制与远程控制
- Node 浏览器代理(零配置默认)
- Browserless(托管远程 CDP)
- 同一主机上的 Browserless Docker
- 直接 WebSocket CDP 提供商
- Browserbase
- Notte
- 安全
- 配置文件(多浏览器)
- 通过 Chrome DevTools MCP 附加到现有会话
- 自定义 Chrome MCP 启动
- 现有会话功能限制
- 隔离保证
- 浏览器选择
- 控制 API(可选)
- 故障排查
- CDP 启动失败与导航 SSRF 阻止
- 智能体工具 + 控制工作原理
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw