OpenClaw 浏览器工具指南

概述

OpenClaw 可以运行代理控制的专用 Chrome/Brave/Edge/Chromium 配置文件。它与您的个人浏览器隔离，通过 Gateway 内的小型本地控制服务管理（仅环回）。

初学者视角：

• 将其视为单独的、仅限代理的浏览器
• openclaw 配置文件不接触您的个人浏览器配置文件
• 代理可以打开标签页、读取页面、点击和在安全通道中输入
• 默认的 chrome 配置文件使用系统默认的 Chromium 浏览器通过扩展中继；切换到 openclaw 以获得隔离管理的浏览器

您获得的功能

• 名为 openclaw 的单独浏览器配置文件（默认橙色强调色）
• 确定性标签控制（列出/打开/聚焦/关闭）
• 代理操作（点击/输入/拖动/选择）、快照、截图、PDF
• 可选的多配置文件支持（openclaw、work、remote 等）

快速开始

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

如果看到 “Browser disabled”，在配置中启用它并重启 Gateway。

配置文件: openclaw vs chrome

设置 browser.defaultProfile: "openclaw" 以默认使用管理模式。

配置

浏览器设置位于 ~/.openclaw/openclaw.json：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "chrome",
    "color": "#FF4500",
    "headless": false,
    "noSandbox": false,
    "executablePath": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
    "profiles": {
      "openclaw": { "cdpPort": 18800, "color": "#FF4500" },
      "work": { "cdpPort": 18801, "color": "#0066CC" },
      "remote": { "cdpUrl": "http://10.0.0.42:9222", "color": "#00AA00" }
    }
  }
}

本地 vs 远程控制

• 本地控制（默认）: Gateway 启动环回控制服务并可以启动本地浏览器
• 远程控制（节点主机）: 在具有浏览器的机器上运行节点主机；Gateway 将浏览器操作代理到它
• 远程 CDP: 设置 browser.profiles.<name>.cdpUrl 以附加到远程基于 Chromium 的浏览器

CLI 快速参考

基础

openclaw browser status
openclaw browser start
openclaw browser stop
openclaw browser tabs
openclaw browser open https://example.com

检查

openclaw browser screenshot
openclaw browser screenshot --full-page
openclaw browser snapshot
openclaw browser snapshot --interactive
openclaw browser console --level error

操作

openclaw browser navigate https://example.com
openclaw browser click 12 --double
openclaw browser type 23 "hello" --submit
openclaw browser press Enter
openclaw browser download e12 /tmp/report.pdf

状态

openclaw browser cookies
openclaw browser cookies set session abc123 --url "https://example.com"
openclaw browser set offline on
openclaw browser set viewport 1280 720

安全和隐私

• openclaw 浏览器配置文件可能包含登录的会话；将其视为敏感
• browser act kind=evaluate 和 openclaw browser evaluate 在页面上下文中执行任意 JavaScript。提示注入可以控制它。如果不需要，使用 browser.evaluateEnabled=false 禁用它
• 保持 Gateway/节点主机私有（环回或仅 tailnet）
• 远程 CDP 端点功能强大；隧道并保护它们

来源: https://docs.openclaw.ai/tools/browser