openclaw browser

管理浏览器控制面（生命周期、profiles、标签页、截图、导航、输入、状态模拟、调试）。

快速开始

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

生命周期

openclaw browser status
openclaw browser doctor          # 基础 CDP 就绪检查
openclaw browser doctor --deep   # 含实时 snapshot 探测
openclaw browser start
openclaw browser start --headless
openclaw browser stop
openclaw browser --browser-profile openclaw reset-profile

Linux 无 DISPLAY/WAYLAND_DISPLAY 时自动 headless，除非显式设置 browser.headless=false。

Profiles 管理

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser create-profile --name remote --cdp-url https://browser-host.example.com
openclaw browser delete-profile --name work
openclaw browser --browser-profile work tabs

内置 profiles：

openclaw：独立 Chrome 实例（隔离 user data dir）
user：通过 Chrome DevTools MCP 控制已登录的 Chrome

标签页操作

openclaw browser tabs
openclaw browser tab new --label docs
openclaw browser tab label t1 docs
openclaw browser tab select 2
openclaw browser tab close 2
openclaw browser open https://example.com --label docs
openclaw browser focus docs
openclaw browser close t1

优先使用 suggestedTargetId（稳定），避免直接使用 raw targetId（导航后可能变化）。

Snapshot / Screenshot / 交互

openclaw browser snapshot
openclaw browser snapshot --urls          # 附加链接目标
openclaw browser screenshot
openclaw browser screenshot --full-page
openclaw browser screenshot --ref e12 --labels
 
# ref 驱动的 UI 自动化
openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"
openclaw browser press Enter
openclaw browser fill --fields '[{"ref":"1","value":"Ada"}]'
openclaw browser wait --text "Done"

状态与存储

openclaw browser resize 1280 720
openclaw browser set offline on
openclaw browser set media dark
openclaw browser set timezone Europe/London
openclaw browser set device "iPhone 14"
openclaw browser cookies
openclaw browser cookies set session abc123 --url https://example.com
openclaw browser storage local set token abc123

调试

openclaw browser console --level error
openclaw browser errors --clear
openclaw browser requests --filter api
openclaw browser responsebody "**/api"
openclaw browser trace start
openclaw browser trace stop --out trace.zip

远程浏览器控制

Gateway 与浏览器不在同一机器时，在有 Chrome 的机器上运行节点主机，Gateway 自动代理浏览器操作：

# 配置自动路由
gateway.nodes.browser.mode
gateway.nodes.browser.node   # 固定到指定节点

命令缺失时

检查 plugins.allow 是否包含 browser：

{ plugins: { allow: ["telegram", "browser"] } }

Wiki AI

目录

CLI - browser 命令