Wiki AI

Browser 工具（Agent 控制浏览器）

2分钟阅读

概述

OpenClaw 内置浏览器控制服务，为 Agent 提供一个独立的 Chrome/Brave/Edge/Chromium Profile（默认名为 openclaw，橙色主题），与用户个人浏览器完全隔离。Agent 可通过该浏览器打开标签页、读取页面、点击、输入，用于自动化和验证任务。

内置 browser-automation skill 教导 Agent 处理 snapshot、stable-tab、stale-ref 和 manual-blocker 恢复循环。

核心功能

  • 独立 Profile：openclaw profile 不影响个人浏览器，支持多 profile（openclaw、work、remote 等）
  • 标签控制：列出/打开/聚焦/关闭标签页
  • Agent 动作：点击、输入、拖拽、选择、截图、PDF、快照
  • 两种快照格式：
    • AI snapshot（数字 ref，如 12）：默认，通过 Playwright aria-ref 解析
    • Role snapshot（角色 ref，如 e12）：--interactive 模式，通过 getByRole() 解析
    • ARIA snapshot（ax12 ref）：--format aria，通过 Chrome backend DOM id 绑定
  • 多 Profile 类型：
    • openclaw（托管 profile）：OpenClaw 启动和管理
    • user（existing-session）：附加到本地已登录 Chrome（Chrome MCP）
    • 远程 CDP profile：通过 cdpUrl 连接远程浏览器

配置/权限

快速启动：

openclaw browser start
openclaw browser open https://example.com
openclaw browser snapshot

基础配置：

{
  browser: {
    enabled: true,
    executablePath: "/usr/bin/google-chrome-stable",
    headless: false,
    defaultProfile: "openclaw"
  }
}

沙箱 Agent 访问宿主机浏览器：

{
  agents: {
    defaults: {
      sandbox: {
        browser: { allowHostControl: true }
      }
    }
  }
}

SSRF 防护（严格模式）：

{
  browser: {
    ssrfPolicy: {
      dangerouslyAllowPrivateNetwork: false,
      hostnameAllowlist: ["*.example.com"]
    }
  }
}

安全注意：browser act kind=evaluate 执行任意 JS，存在 prompt injection 风险，可通过 browser.evaluateEnabled=false 禁用。

相关页面

关系图谱

反向链接