browser

浏览器控制 CLI（支持 Chrome/Brave/Edge/Chromium）。

用法

openclaw browser <子命令> [选项]

通用选项

• --url: 网关 URL
• --token: 网关 token
• --timeout: 超时时间
• --json: JSON 输出
• --browser-profile <name>: 浏览器配置文件

管理命令

browser status

查看浏览器状态。

openclaw browser status

browser start

启动浏览器。

openclaw browser start

browser stop

停止浏览器。

openclaw browser stop

browser reset-profile

重置浏览器配置文件。

openclaw browser reset-profile

browser tabs

列出打开的标签页。

openclaw browser tabs

browser open

打开 URL。

openclaw browser open <url>

browser focus

聚焦标签页。

openclaw browser focus <targetId>

browser close

关闭标签页。

openclaw browser close [targetId]

检查命令

browser screenshot

截图。

openclaw browser screenshot [targetId] [选项]

选项：

• --full-page: 全页截图
• --ref <ref>: 元素引用
• --element <selector>: 元素选择器
• --type png|jpeg: 图片类型

browser snapshot

获取页面快照。

openclaw browser snapshot [选项]

选项：

• --format aria|ai: 格式
• --target-id <id>: 目标 ID
• --limit <n>: 限制
• --interactive: 交互模式
• --compact: 紧凑模式
• --depth <n>: 深度
• --selector <sel>: 选择器
• --out <path>: 输出路径

操作命令

browser navigate

导航到 URL。

openclaw browser navigate <url> [--target-id <id>]

browser click

点击元素。

openclaw browser click <ref> [选项]

选项：

• --double: 双击
• --button <left|right|middle>: 按钮
• --modifiers <csv>: 修饰键
• --target-id <id>: 目标 ID

browser type

输入文本。

openclaw browser type <ref> <text> [选项]

选项：

• --submit: 提交
• --slowly: 慢速输入
• --target-id <id>: 目标 ID

browser press

按键。

openclaw browser press <key> [--target-id <id>]

browser hover

悬停。

openclaw browser hover <ref> [--target-id <id>]

browser fill

填充表单。

openclaw browser fill [--fields <json>] [--fields-file <path>] [--target-id <id>]

browser wait

等待。

openclaw browser wait [选项]

选项：

• --time <ms>: 等待时间
• --text <value>: 等待文本出现
• --text-gone <value>: 等待文本消失
• --target-id <id>: 目标 ID

示例

# 查看浏览器状态
openclaw browser status

# 启动浏览器
openclaw browser start

# 打开网页
openclaw browser open https://example.com

# 截图
openclaw browser screenshot --full-page

# 点击元素
openclaw browser click "button#submit"

# 输入文本
openclaw browser type "#search" "OpenClaw"

# 导航
openclaw browser navigate https://github.com

相关文档

• 浏览器工具
• Chrome 扩展