OpenClaw Browser Relay：AI 直接控制浏览器指南

2026-04-19 2026-05-07 约 1000 字预计阅读 2 分钟

OpenClaw 控制的是一个专用 Chrome 配置文件（名为 openclaw，UI 带橙色色调）。
它与你日常使用的浏览器配置文件是分开的。
对于智能体浏览器工具调用：

默认选择：智能体应使用其隔离的 openclaw 浏览器。
仅当现有登录会话很重要，且用户本人就在电脑前可以点击/批准任何附加提示时，才使用 profile="user"。
如果你有多个用户浏览器配置文件，请显式指定配置文件，而不要猜测。
有两种简单方式访问它：

让智能体打开浏览器，然后你自己完成登录。
通过 CLI 打开它：

1
2
3
4
5
6
7
8
9
openclaw browser start
openclaw browser open https://x.com

openclaw browser --browser-profile openclaw doctor
openclaw browser --browser-profile openclaw doctor --deep
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

安装 Google Chrome

安装官方的 Google Chrome .deb 包，它不受 snap 沙箱限制：

1
2
3
4
5
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y  # 如果出现依赖错误

google-chrome --version

然后更新你的 OpenClaw 配置（~/.openclaw/openclaw.json）：

1
2
3
4
5
6
7
8
{
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/google-chrome-stable",
    "headless": true,
    "noSandbox": true
  }
}

配置参考

选项	说明	默认值
`browser.enabled`	启用浏览器控制	`true`
`browser.executablePath`	基于 Chromium 的浏览器二进制路径（Chrome/Brave/Edge/Chromium）	自动检测（优先选择默认浏览器，前提是其基于 Chromium）
`browser.headless`	以无 GUI 模式运行	`false`
`OPENCLAW_BROWSER_HEADLESS`	针对本地受管浏览器无头模式的按进程覆盖	未设置
`browser.noSandbox`	添加 `--no-sandbox` 标志（某些 Linux 环境需要）	`false`
`browser.attachOnly`	不启动浏览器，仅附加到现有浏览器	`false`
`browser.cdpPort`	Chrome DevTools Protocol 端口	`18800`
`browser.localLaunchTimeoutMs`	本地受管 Chrome 发现超时时间	`15000`
`browser.localCdpReadyTimeoutMs`	本地受管启动后 CDP 就绪超时时间	`8000`

智能体指引

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# 打开页面
openclaw browser --browser-profile openclaw open https://github.com
# 查看当前标签页
openclaw browser --browser-profile openclaw tabs
# 抓取页面快照，输出 DOM 快照和页面文本结构。AI Agent 主要就是靠这个理解页面。
openclaw browser --browser-profile openclaw snapshot
# 截图
openclaw browser --browser-profile openclaw screenshot
# 导出 PDF
openclaw browser --browser-profile openclaw pdf

让AI操作网页

打开页面后在OpenClaw 会话里直接说：

1
打开 github 搜索 unsloth 项目

它会自动：

定位输入框
输入关键词
回车
打开项目页
因为 managed browser 的工具已经内置到 agent。

如何在 AI 对话里直接控制

配置文件：
~/.openclaw/openclaw.json

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
  plugins: {
    allow: ["telegram", "browser"],
  },
}
# openclaw：受管理、隔离的浏览器（无需扩展）。
# user：内置的 Chrome MCP 附加配置文件，用于你的真实已登录 Chrome会话。
{  
  "browser": {  
    "defaultProfile": "openclaw" 
    "executablePath": "/usr/bin/google-chrome" 
  }  
}

这样以后在对话里直接说：
帮我打开 github 搜索 llama.cpp
AI 会自动调用浏览器。
不需要你手动执行 CLI。

经过验证，目前Chrome关于OpenClaw Browser Relay的扩展都不太靠谱，浏览器操作建议参考以下官方说明

OpenClaw Browser RelayAI 直接控制浏览器官方说明

OpenClaw Browser Relay：AI 直接控制浏览器指南

安装 Google Chrome

配置参考

智能体指引

让AI操作网页

如何在 AI 对话里直接控制

经过验证，目前Chrome关于OpenClaw Browser Relay的扩展都不太靠谱，浏览器操作建议参考以下官方说明

最新官方中文使用手册

相关内容

目录