browser

`openclaw browser`

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

通用标志

--url <gatewayWsUrl>：Gateway(网关) WebSocket URL（默认为配置中的值）。
--token <token>：Gateway(网关) 令牌（如果需要）。
--timeout <ms>：请求超时（毫秒）。
--browser-profile <name>：选择浏览器配置文件（默认来自配置）。
--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

如果缺少命令

如果 openclaw browser 是未知命令，请检查 plugins.allow 中的 ~/.openclaw/openclaw.json。

当存在 plugins.allow 时，必须显式列出捆绑的浏览器插件：

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

如果插件允许列表排除了 browser，browser.enabled=true 不会恢复 CLI 子命令。

配置文件

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

openclaw：启动或附加到专用的 OpenClaw 管理的 Chrome 实例（隔离的用户数据目录）。
user：通过 Chrome DevTools MCP 控制现有的已登录 Chrome 会话。
自定义 CDP 配置文件：指向本地或远程 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

使用特定的配置文件：

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"

通过 MCP 连接现有的 Chrome

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

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

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

远程浏览器控制（节点主机代理）

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

如果连接了多个节点，请使用 gateway.nodes.browser.mode 控制自动路由，并使用 gateway.nodes.browser.node 固定特定节点。

安全性和远程设置：浏览器工具、远程访问、Tailscale、安全性