openclaw browser

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

相关文档：

• Browser 工具 + API：Browser tool

常用标志

• --url <gatewayWsUrl>：Gateway WebSocket URL（默认使用配置值）。
• --token <token>：Gateway token（如需认证）。
• --timeout <ms>：请求超时（毫秒）。
• --browser-profile <name>：选择浏览器 Profile（默认来自配置）。
• --json：机器可读输出（在支持的地方）。

快速开始（本地）

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

Profiles

Profiles 是命名的浏览器路由配置。实际上：

• openclaw：启动或附加到 OpenClaw 管理的专用 Chrome 实例（隔离的用户数据目录）。
• user：通过 Chrome DevTools MCP 控制你现有的已登录 Chrome 会话。
• 自定义 CDP profiles：指向本地或远程 CDP 端点。

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser delete-profile --name work

使用特定 profile：

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

导航/点击/输入（基于 ref 的 UI 自动化）：

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

接入已有 Chrome（通过 MCP）

使用内置的 user profile，或创建你自己的 existing-session profile：

openclaw browser --browser-profile user tabs
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser create-profile --name brave-live --driver existing-session --user-data-dir "~/Library/Application Support/BraveSoftware/Brave-Browser"
openclaw browser --browser-profile chrome-live tabs

让你的龙虾直接操控你已登录的浏览器——Cookie、登录状态全都带着，省去二次登录的麻烦。

此路径仅适用于宿主机。对于 Docker、无头服务器、Browserless 或其他远程设置，请使用 CDP profile。

远程浏览器控制（Node Host 代理）

如果 Gateway 运行在与浏览器不同的机器上，请在有 Chrome/Brave/Edge/Chromium 的机器上运行 Node Host。Gateway 会将浏览器操作代理到该节点（无需单独的浏览器控制服务器）。

使用 gateway.nodes.browser.mode 控制自动路由，使用 gateway.nodes.browser.node 在连接多个节点时固定特定节点。

安全性 + 远程设置：Browser tool、Remote access、Tailscale、Security