Tools 导读

给Agent一个独立的浏览器,不碰你的个人资料

OpenClaw 会启动一个名为 openclaw 的专用浏览器配置文件,与你的日常浏览器完全隔离。先运行 `openclaw browser --browser-profile openclaw start` 启动它,如果命令不可用,检查 `plugins.allow` 是否包含 `browser`。

先讲这一页到底在解决什么

给Agent一个独立的浏览器,不碰你的个人资料

OpenClaw 会启动一个名为 openclaw 的专用浏览器配置文件,与你的日常浏览器完全隔离。先运行 `openclaw browser --browser-profile openclaw start` 启动它,如果命令不可用,检查 `plugins.allow` 是否包含 `browser`。

原文共 26 节,先看 Start Here 路径:/tools/browser 查看官方原文

第一站

🧡 先想画面:OpenClaw 有自己的一台小浏览器,不去乱翻你的私人书包

官方最想先讲明白的一件事,就是默认的 openclaw 浏览器 profile 跟你平时用的浏览器不是同一个东西。

🧡 openclaw profile

像给代理准备的一台橙色专用电脑。它有自己的浏览器资料夹,不会直接碰你日常那台。

👤 user profile

像临时借用你自己正在登录着的浏览器。它更方便,但风险也更高,因为那里面是真账号、真登录态。

🌍 remote profile

像连去另一台远端浏览器,不是本地开窗,而是隔着 CDP 线去控制。

⭐ 如果你只先记一句

默认先用专用浏览器,只有真的需要登录态时,再考虑借用用户浏览器。

第二站

🚀 Quick start 那几条命令,其实就是“开机、开网页、看一眼页面地图”

原文开头的四条命令已经把最基础的动作讲完了。

openclaw browser status

像先问一句:“那台专用浏览器现在开着没?”

openclaw browser start

像按下电源键,把代理的小浏览器开起来。

openclaw browser open https://example.com

像把一张网址纸条递给它,让它把目标网页真正打开。

openclaw browser snapshot

像让它把当前页面画成一张“可操作地图”,告诉你按钮、输入框、链接都在哪儿。

第三站

🗂 Profiles 不是花样名字,而是在选“这次到底控制哪台浏览器”

这页配置看着多,其实大部分都围着 profile 在转。profile 就像一张“浏览器身份卡”。

🧡

openclaw

默认专用机。第一次用浏览器工具,最推荐先走这个。

💼

work

像第二台专用机。你可以给不同任务准备不同 profile,各自有自己的标签色和端口。

👤

user / brave

像借用你真人浏览器的现有登录态。只有真的需要登录状态时才该这么做。

🌐

remote

像把操控线接到另一台机器上的浏览器,而不是在本地直接开一扇窗。

第四站

🛠 snapshot、click、type,不是在魔法操作网页,而是在按页面地图找路

官方后半段不断强调 refs,是因为浏览器工具并不是瞎点,它会先拿到一张页面地图,再根据地图上的编号动作。

🗺 snapshot

像先把当前页面画成一张可操作地图,地图上每个按钮和输入框都有自己的编号。

👆 click 12

不是凭空点,而是按地图上的 12 号点去按下那个按钮。

⌨️ type 23 "hello"

像在 23 号输入框里替你打字,不是随便往网页某处乱塞文本。

📸 screenshot

像拍一张现场照片。snapshot 偏“地图”,screenshot 偏“照片”,两者不是同一样东西。

第五站

🔐 Browser 的安全重点,不是“能不能开网页”,而是“别碰错浏览器、别连错地方”

原文关于 SSRF、remote CDP、host browser access 讲得很多,其实都在提醒同一件事:这条线不要乱接。

🏖 sandbox 默认更安全

如果会话是沙箱的,浏览器动作也更偏在安全围栏里做。想碰 host browser,得明确允许。

🚫 SSRF guard

像门卫先看目标地址是不是危险内网、私网、奇怪的远端入口,别让浏览器变成乱跑的探针。

🌐 remote CDP URL

这东西像远程遥控密码线。填错了连不上,保护不好则像把另一台浏览器的控制绳暴露出去了。

📌 user profile 为什么更高风险

因为那不是空白测试浏览器,而是你真人已经登录着的浏览器。它看到的页面和账号,真的就是你的。

第六站

🛎 浏览器 CLI 命令别背,先看它们各自在现场做什么

这页后半部分命令超级多,但大多数都能归到几个简单动作里。

openclaw browser tabs

像看看这台浏览器现在开着哪些标签页。

openclaw browser wait --url "**/dash"

像站在门口等一会儿,直到页面真的走到你要的那一站。

openclaw browser highlight e12

像把你准备点击的那个页面元素先圈出来,确认 Playwright 盯的到底是不是它。

openclaw browser trace start / stop

像把整个现场录像打开。真遇到难查的网页动作问题,这比盲猜有用得多。

最后总结

🎈 把 Browser 这页压成一句最好记的话

Browser 工具就是给 OpenClaw 一台专用浏览器和一张页面地图,让它能在尽量隔离、尽量可控的前提下去动网页。

如果你下一页只想继续看一页,我建议看 /tools/browser-login。因为一旦真的碰登录态,浏览器工具最重要的问题就会从“会不会点”变成“该不该借用真人浏览器”。