openclaw browser

管理 OpenClaw 的浏览器控制服务,并执行浏览器操作(标签页、快照、截图、导航、点击、输入)。

相关文档:

常用参数

  • --url <gatewayWsUrl>:Gateway WebSocket 地址(默认使用配置文件中的值)。
  • --token <token>:Gateway token(如果需要)。
  • --timeout <ms>:请求超时时间(毫秒)。
  • --browser-profile <name>:选择浏览器配置文件(默认使用配置文件中的值)。
  • --json:机器可读的输出格式(部分命令支持)。

快速开始(本地)

openclaw browser --browser-profile chrome tabs
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

配置文件(Profiles)

配置文件是命名的浏览器路由配置。实际使用中:

  • openclaw:启动或连接到一个由 OpenClaw 管理的专用 Chrome 实例(独立的用户数据目录)。
  • chrome:通过 Chrome 扩展中继控制你现有的 Chrome 标签页。
openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work

使用特定的配置文件:

openclaw browser --browser-profile work tabs

标签页

openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>

快照 / 截图 / 操作

快照:

openclaw browser snapshot

截图:

openclaw browser screenshot

导航/点击/输入(基于引用的 UI 自动化):

openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"

Chrome 扩展中继(通过工具栏按钮连接)

这个模式让 Agent 控制你手动连接的现有 Chrome 标签页(不会自动连接)。

安装未打包的扩展到稳定路径:

openclaw browser extension install
openclaw browser extension path

然后打开 Chrome → chrome://extensions → 启用”开发者模式”→ 点击”加载已解压的扩展程序”→ 选择打印出的文件夹。

完整指南:Chrome 扩展

远程浏览器控制(node host 代理)

如果 Gateway 和浏览器运行在不同的机器上,在有 Chrome/Brave/Edge/Chromium 的机器上运行一个 node host。Gateway 会将浏览器操作代理到那个 node(不需要单独的浏览器控制服务)。

使用 gateway.nodes.browser.mode 控制自动路由,使用 gateway.nodes.browser.node 指定特定的 node(如果连接了多个)。

安全 + 远程设置:浏览器工具远程访问Tailscale安全