图片资源未同步：未命名图片

OpenClaw 浏览器搜索与自动化：托管模式 vs 扩展中继，一篇搞懂

很多人第一次用 OpenClaw 的浏览器能力，会卡在两件事上：

到底该用哪种浏览器模式？（托管 vs 扩展中继）
为什么“扩展中继找不到标签页”？（Chrome extension relay is running, but no tab is connected）

本篇把官方文档的核心点（Browser 工具 + Chrome 扩展）和常见坑揉成一套可直接照抄的操作手册：从启动、搜索、自动化到排错。

参考：

浏览器（OpenClaw 托管）：https://docs.openclaw.ai/zh-CN/tools/browser
Chrome 扩展（浏览器中继）：https://docs.openclaw.ai/zh-CN/tools/chrome-extension

0）先讲结论：两种玩法怎么选

方案 A：托管浏览器模式（openclaw profile）——默认推荐

适用场景：

日常网页搜索、抓取、表单操作
不依赖你个人 Chrome 的登录态
需要更安全的隔离（不串 Cookie、不串历史）

特点：

OpenClaw 自己启动一套独立浏览器配置文件
通过 CDP（Chrome DevTools Protocol）控制
默认只在本地 127.0.0.1 跑，更安全

方案 B：扩展中继模式（chrome profile）——需要复用“真实 Chrome 环境”时用

适用场景：

必须沿用你当前 Chrome 的登录态 / Cookie / 插件环境
目标网站反自动化很强（沙箱/新 Profile 更容易被识别）

特点：

OpenClaw 不启动浏览器
通过 Chrome 扩展控制你已打开的某个标签页
需要你手动把标签页“挂”到扩展上

一句话：

不需要登录态 → 用托管模式；需要复用登录态 → 用扩展中继。

1）OpenClaw 怎么“搜索网页”：推荐工作流

OpenClaw 里跟网页相关的能力，建议分两层用：

轻量层（优先）：web_search / web_fetch 先找链接、先抓内容（快、便宜）
浏览器层（必要时）：页面要交互/要登录/重 JS 渲染，才用 browser 工具

工程上的最佳实践是：

先用 web_search 找 5~10 个候选
再用浏览器打开最关键的 1~3 个页面做交互/截图/表单

这样不会把浏览器当 RSS 解析器，也不会一上来就走最重路径。

2）托管模式：从启动到操作（可直接照抄）

2.1 启动托管浏览器

openclaw browser start --browser-profile openclaw

2.2 打开网页

openclaw browser open https://example.com --browser-profile openclaw

2.3 调试/交互（最常用两条）

openclaw browser status
openclaw browser snapshot --interactive

status：确认浏览器是不是活着、CDP 通不通
snapshot --interactive：拿交互快照，试点/输/跳转，定位问题最快

经验：你在 interactive snapshot 里点得到的，自动化通常也能做；点不到基本是定位、遮挡或权限问题。

3）扩展中继模式：正确姿势（避免“找不到标签页”）

3.1 安装扩展

openclaw browser extension install

然后在 Chrome 里按官方文档加载扩展（未打包模式）。

3.2 把标签页“挂”到扩展上

经典报错：

Chrome extension relay is running, but no tab is connected

原因非常单纯：

中继模式只控制“你已打开并附加的某个 tab”
没有 tab 被附加 → OpenClaw 无处下手

正确流程：

打开你想控制的 Chrome 标签页
点击 OpenClaw 扩展图标
选择“附加/连接该标签页”（让 badge 变成 ON/已连接）
再执行需要浏览器控制的操作

4）常见坑：扩展中继找不到标签页（为什么 + 两种解法）

这是用 chrome 配置文件（扩展中继模式）时的专属问题：

OpenClaw 不会自己启动浏览器
通过扩展去控制你已经打开的 Chrome 标签页
扩展没装 / 标签页没挂上 → 必报错

解法 1：切回托管浏览器模式（最省事）

openclaw browser start --browser-profile openclaw

或在配置文件设置默认 profile：

{ "browser": { "defaultProfile": "openclaw" } }

解法 2：坚持用扩展中继（需要你手动挂 tab）

安装 OpenClaw 浏览器扩展
打开一个 Chrome 标签页
点击扩展图标，把该 tab 附加到控制系统

5）多配置文件：一个不够用？那就来几个

OpenClaw 允许你配置多个“浏览器环境”，分别指向不同浏览器实例或远程 CDP。

示例：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw",
    "profiles": {
      "openclaw": { "cdpPort": 18800, "color": "#FF4500" },
      "work": { "cdpPort": 18801, "color": "#0066CC" },
      "remote": { "cdpUrl": "http://10.0.0.42:9222", "color": "#00AA00" }
    }
  }
}

典型用法：

测试环境一个 profile（干净、隔离）
需要登录态的业务站点一个 profile（稳定复用 Cookie）

6）登录问题：千万别把密码喂给 AI（只手动登录）

硬规则：别把账号密码给 AI。

正确姿势：

openclaw browser start --browser-profile openclaw
openclaw browser open https://x.com --browser-profile openclaw

然后你自己在打开的浏览器窗口里完成登录。登录态会保存在 OpenClaw 的 profile 里，后续自动化复用。

为什么不让 AI 自动登：

安全隐患（密码可能进日志/对话）
行为特征明显，容易触发风控/封号

7）沙箱模式的坑：有时反而容易被识破（什么时候用 host）

对 Twitter/X 这类风控强的网站，托管/沙箱浏览器可能更像机器人。

此时可以允许使用主机浏览器控制（需要你自己评估风险）：

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main",
        "browser": { "allowHostControl": true }
      }
    }
  }
}

并在命令中指定：

openclaw browser open https://x.com --browser-profile openclaw --target host

8）配置参数速查表（常用）

配置项	说明	默认/常见值
browser.enabled	启用浏览器控制	true
browser.executablePath	浏览器路径	自动检测
browser.headless	无界面模式	false
browser.noSandbox	加 `--no-sandbox`	false
browser.attachOnly	仅附加，不启动	false
browser.cdpPort	CDP 端口	18800
browser.defaultProfile	默认 profile	openclaw / chrome

想用 Brave/Edge：把 executablePath 指到 Chromium 内核浏览器即可。

9）调试技巧：出问题了按这 5 步排查

先看浏览器活着没：

openclaw browser status

交互式快照：

openclaw browser snapshot --interactive

元素不可见/被遮挡：用 highlight 看定位到谁（按官方文档）
复杂问题开 trace：

openclaw browser navigate https://example.com --trace

需要结构化输出：加 --json 便于脚本处理

#OpenClaw #AIagent #Browser #自动化