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(如果连接了多个)。