Skip to main content

​
浏览器

OpenClaw 可以运行一个 专用的 Chrome/Brave/Edge/Chromium 配置文件,由代理控制。它与您的个人浏览器隔离,并通过网关(仅环回接口)内部一个小型本地控制服务进行管理。

​
快速开始

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
如果提示”浏览器已禁用”,请在配置中启用,然后重启网关。

​
配置文件:openclaw vs chrome

  • openclaw:托管的、隔离的浏览器(不需要扩展)。
  • chrome:通过扩展中继连接您的系统浏览器(需要在标签页安装 OpenClaw 扩展)。
如果您希望默认使用托管模式,请设置 browser.defaultProfile: "openclaw"。

​
配置

浏览器设置存放于 ~/.openclaw/openclaw.json。 
{
  browser: {
    enabled: true,
    defaultProfile: "openclaw",
    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" },
    },
  },
}

​
快照与引用(refs)

OpenClaw 支持两种”快照”样式:

​
AI 快照(数字引用)

openclaw browser snapshot
openclaw browser click 12
openclaw browser type 23 "hello"

​
角色快照(角色引用 e12)

openclaw browser snapshot --interactive
openclaw browser click e12
openclaw browser highlight e12

​
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
openclaw browser type 23 "hello" --submit
openclaw browser press Enter
openclaw browser wait --text "Done"

​
安全性

  • openclaw 浏览器配置文件可能含已登录的会话,请视为敏感信息。
  • browser act kind=evaluate 会执行页面上下文中任意 JS,可能受提示注入控制。如不需要,设置 browser.evaluateEnabled=false 禁用。
  • 保持网关/节点宿主私有(仅环回或 Tailscale 网络)。