openclaw
默认专用机。第一次用浏览器工具,最推荐先走这个。
Tools 导读
OpenClaw 会启动一个名为 openclaw 的专用浏览器配置文件,与你的日常浏览器完全隔离。先运行 `openclaw browser --browser-profile openclaw start` 启动它,如果命令不可用,检查 `plugins.allow` 是否包含 `browser`。
先讲这一页到底在解决什么
OpenClaw 会启动一个名为 openclaw 的专用浏览器配置文件,与你的日常浏览器完全隔离。先运行 `openclaw browser --browser-profile openclaw start` 启动它,如果命令不可用,检查 `plugins.allow` 是否包含 `browser`。
第一站
官方最想先讲明白的一件事,就是默认的 openclaw 浏览器 profile 跟你平时用的浏览器不是同一个东西。
像给代理准备的一台橙色专用电脑。它有自己的浏览器资料夹,不会直接碰你日常那台。
像临时借用你自己正在登录着的浏览器。它更方便,但风险也更高,因为那里面是真账号、真登录态。
像连去另一台远端浏览器,不是本地开窗,而是隔着 CDP 线去控制。
默认先用专用浏览器,只有真的需要登录态时,再考虑借用用户浏览器。
第二站
原文开头的四条命令已经把最基础的动作讲完了。
openclaw browser status像先问一句:“那台专用浏览器现在开着没?”
openclaw browser start像按下电源键,把代理的小浏览器开起来。
openclaw browser open https://example.com像把一张网址纸条递给它,让它把目标网页真正打开。
openclaw browser snapshot像让它把当前页面画成一张“可操作地图”,告诉你按钮、输入框、链接都在哪儿。
第三站
这页配置看着多,其实大部分都围着 profile 在转。profile 就像一张“浏览器身份卡”。
默认专用机。第一次用浏览器工具,最推荐先走这个。
像第二台专用机。你可以给不同任务准备不同 profile,各自有自己的标签色和端口。
像借用你真人浏览器的现有登录态。只有真的需要登录状态时才该这么做。
像把操控线接到另一台机器上的浏览器,而不是在本地直接开一扇窗。
第四站
官方后半段不断强调 refs,是因为浏览器工具并不是瞎点,它会先拿到一张页面地图,再根据地图上的编号动作。
像先把当前页面画成一张可操作地图,地图上每个按钮和输入框都有自己的编号。
不是凭空点,而是按地图上的 12 号点去按下那个按钮。
像在 23 号输入框里替你打字,不是随便往网页某处乱塞文本。
像拍一张现场照片。snapshot 偏“地图”,screenshot 偏“照片”,两者不是同一样东西。
第五站
原文关于 SSRF、remote CDP、host browser access 讲得很多,其实都在提醒同一件事:这条线不要乱接。
如果会话是沙箱的,浏览器动作也更偏在安全围栏里做。想碰 host browser,得明确允许。
像门卫先看目标地址是不是危险内网、私网、奇怪的远端入口,别让浏览器变成乱跑的探针。
这东西像远程遥控密码线。填错了连不上,保护不好则像把另一台浏览器的控制绳暴露出去了。
因为那不是空白测试浏览器,而是你真人已经登录着的浏览器。它看到的页面和账号,真的就是你的。
第六站
这页后半部分命令超级多,但大多数都能归到几个简单动作里。
openclaw browser tabs像看看这台浏览器现在开着哪些标签页。
openclaw browser wait --url "**/dash"像站在门口等一会儿,直到页面真的走到你要的那一站。
openclaw browser highlight e12像把你准备点击的那个页面元素先圈出来,确认 Playwright 盯的到底是不是它。
openclaw browser trace start / stop像把整个现场录像打开。真遇到难查的网页动作问题,这比盲猜有用得多。
最后总结
Browser 工具就是给 OpenClaw 一台专用浏览器和一张页面地图,让它能在尽量隔离、尽量可控的前提下去动网页。
如果你下一页只想继续看一页,我建议看 /tools/browser-login。因为一旦真的碰登录态,浏览器工具最重要的问题就会从“会不会点”变成“该不该借用真人浏览器”。