browser

`openclaw browser`

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

常用标志

--url <gatewayWsUrl>: 网关 WebSocket URL (默认为配置)。
--token <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

配置文件

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

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 扩展中继 (通过工具栏按钮附加)

此模式允许代理控制您手动附加的现有 Chrome 标签页 (它不会自动附加)。

将解压后的扩展安装到稳定路径:

openclaw browser extension install
openclaw browser extension path

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

完整指南: Chrome extension