前两篇我们把 OpenClaw 的内置工具箱挨个过了一遍，末了还留了个尾巴：其中有两个工具细节比较多。打算各开一篇单独讲，一个是浏览器工具 browser一个是 ACP。这一篇就先来学习 OpenClaw 的 browser 工具。

browser 会真的开起一个 Chromium 浏览器，像人一样去操作网页。解决的是前面 web_searchx_searchweb_fetch 那套轻量工具搞不定的场景：要登录、要点按钮、内容得靠 JS 才渲染得出来的页面。老实说，它功能最强，配置也最讲究，光「浏览器跑在哪」就有 hostsandboxnode 三种情况。「用哪个浏览器」又分好几种 profile，内容实在不少，于是我们把这一个工具拆成上下两篇：这一篇先把环境铺好；下一篇再讲环境就绪之后怎么真正驱动浏览器在页面上干活。话说回来，

使用者痛点：很多同学在实际项目里遇到登录态失效、验证码拦截、还有不同运行环境配置不统一的问题。这些都让自动化脚本频繁崩溃。下面的内容将一步步帮你拆解这些痛点。不过，

工具参数定义

和前面的 messagenodes 一样，浏览器在 agent 侧也只暴露 browser 一个工具。靠不同的 action 分派不同的操作：

Pain Point：动作种类太多记不清？看完这张图，你能快速定位自己需要的 action。怎么说呢，

它的 action 覆盖了一整套浏览器生命周期，粗看可以分成三组：

• 进程和环境：doctorstartstop
• tag 页管理：tag.list。tag.open,tag.switch,tag.close
• 页面交互： 导航、取结构、截图、执行动作；外加读日志、导出 PDF、传文件、处理弹窗等

整理成一张图大致如下：

其中 act 本身又是个小分派器，要执行的动作由 kind 指定。对应参数（推荐打包进 `request ` 对象）随 `kind` 不同而不同：

Pain Point：`request` 参数结构混乱？其实，建议统一使用 JSON 对象包装所有子参数，以免遗漏。

运行位置

和 `exec` 的 `host` 参数类似。`browser` 也有一个 `target` 参数，取值是 `host` / `sandbox` / `node` 三种。不传 `target` 时OpenClaw 按会话类型挑默认值：沙箱会话默认 `sandbox`，非沙箱会话默认 `host`；要是有一台带可控浏览器的 node 连了进来工具还可能自动路由到那台 node 上。不过，三个取值里 `host` 最直白、也最常用，非沙箱会话默认就走它，你不用做任何配置。所以下面先从 `host` 讲起，再回头看 `sandbox` 和 `node`。

在 host 上运行浏览器

当 `target="host"` 时就是在网关那台机器上启动或接管一个本地浏览器。启动哪个浏览器呢，这就要靠 `profile` 来确定了。 OpenClaw 在 host 上内置了两个 profile：

• `openclaw`： 一个专用的、隔离的 Chromium 实例；风险低，和你个人浏览器完全隔离。
• `user`： 经 Chrome DevTools MCP 接管你真实的、已登录的 Chrome；风险高，在你的登录身份里操作。

下面先说 **`openclaw` profile**。

Pain Point：`user` profile 需要手动授权弹窗，如果无人值守会导致卡死。

openclaw profile 的细节

• 专门给 agent 自动化用的隔离 profile。用的是一份独立的使用者数据目录，不会碰你个人浏览器的 profile；
• CDP 端口从 `-20000~ -21000)` 区间里分配，特意避开常见端口冲突；
li style=“color:#FF4500;” 为窗口加了一圈橙色外框，方便辨识；li 如果本机找不到指定浏览器时会按 Chrome → Brave → Edge → Chromium → Chrome Canary 顺序自动挑选可用版本。li CDP 是 Chromium 对外暴露的一套远程控制接口，各类自动化框架正是通过它驱动浏览器。li 使用时请确保本机已装 Chromium 或兼容浏览器，否则会报错找不到可执行文件。话说回来，li 建议在生产环境开启无头模式 来节约资源。li 如需调试，可关闭无头并观察橙色边框窗口。说起来，li 注意：若使用 Docker 容器。请映射 CDP 端口至宿主机以便外部访问。按理说，li 常见错误：端口被占用 → 手动指定未占用端口或让程序自动分配。不过，li 请务必保持 Chrome 与 OpenClaw 同步更新。否则可能出现协议不兼容问题。li 推荐使用官方提供的最新 stable 版本以获得最佳兼容性。li 如果遇到 “Target closed” 错误，请检查防火墙或安全组是否阻止 CDP 端口。li 可通过设置 env var OPENCLAW_BROWSER_HEADLESS=true 强制无头运行。
• If you have a different OS or architecture,you may need to set executablePath manually.

user profile 的细节与限制

• The agent will attach to an already‑running Chrome instance via official MCP attach flow.
• This is useful when you’ve already logged into a site and want agent to reuse that session.
• The approach is considered high‑risk because agent operates with your personal credentials.
• The profile does NOT start a new browser – it only attaches to an existing one.
• You must manually approve attach permission dialog that pops up on your machine.
• The UI shows a small “Attach” notification from Chrome;click “Allow”.
• If you deny or ignore it,tool will timeout and report an error.

""".replace

'''

---

"""

---

*""".strip """"

---

]

""" --- """""""""""""""""""""""""""""""" ] # End of answer

---