OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书
查看原始文档 最近生成：2026/03/08 15:37

简要总结

browser

这页说明书是教你用 openclaw browser 这个命令来玩电脑里的浏览器的。你可以用它来打开新网页、给网页拍照片、或者让电脑自己点按钮和打字。当你需要让电脑帮你操作浏览器，或者想看看浏览器里现在打开了哪些网页时，就可以看看这页。

五岁小孩版解释

openclaw browser 是一个神奇的命令，就像你有一个遥控器，可以指挥电脑里的浏览器做事情。你可以让它打开新网页、查看所有打开的网页、给网页拍快照（就像用相机咔嚓一下），甚至让它帮你点击屏幕上的按钮和打字。

开始之前，你需要知道一些“魔法开关” 这些“魔法开关”是加在命令后面的，可以改变命令的效果。比如：

  • --url：告诉命令你要连接的控制中心在哪里（像一个地址）。
  • --token：如果控制中心需要密码，就用这个开关告诉它。
  • --timeout：设置命令愿意等待多久（单位是毫秒，1000毫秒=1秒）。
  • --browser-profile：选择一个浏览器“身份”。就像你有不同的玩具箱，每个玩具箱里的玩具不一样。这里有两个主要的“身份”：
    • openclaw：这个身份会打开一个专门给 OpenClaw 用的、干净的浏览器窗口。
    • chrome：这个身份会控制你电脑上已经打开的、普通的 Chrome 浏览器窗口。
  • --json：让电脑用它能更好读懂的方式（JSON格式）来回答你。

怎么开始玩呢？ 你可以先试试这几个简单的命令，就像玩游戏一样：

  1. 看看你普通浏览器里打开了哪些网页：openclaw browser --browser-profile chrome tabs
  2. 启动一个专门的浏览器窗口：openclaw browser --browser-profile openclaw start
  3. 在那个专门的窗口里打开一个网站：openclaw browser --browser-profile openclaw open https://example.com
  4. 给那个网站拍一张快照：openclaw browser --browser-profile openclaw snapshot

管理你的浏览器“身份” 你可以创建、查看和删除不同的“身份”（他们叫“Profiles”）。

  1. 看看现在有哪些“身份”：openclaw browser profiles
  2. 创建一个叫“work”的新“身份”：openclaw browser create-profile --name work --color "#FF5A36"
  3. 删除“work”这个“身份”：openclaw browser delete-profile --name work
  4. 以后想用“work”这个身份来做事，就在命令里加上它：openclaw browser --browser-profile work tabs

控制浏览器里的网页（标签页）

  1. 列出所有打开的网页：openclaw browser tabs
  2. 打开一个新网页：openclaw browser open https://docs.openclaw.ai
  3. 切换到某个特定的网页：openclaw browser focus <targetId> （这里的 <targetId> 是网页的编号，从 tabs 命令里能看到）
  4. 关掉一个网页：openclaw browser close <targetId>

给网页拍照和操作网页

  1. 拍一张网页快照（会保存很多网页信息）：openclaw browser snapshot
  2. 拍一张普通的屏幕截图：openclaw browser screenshot
  3. 让浏览器去一个新网址：openclaw browser navigate https://example.com
  4. 点击网页上的某个东西：openclaw browser click <ref> （<ref> 是屏幕上那个东西的代号）
  5. 在网页上的某个地方打字：openclaw browser type <ref> "hello"

用 Chrome 扩展来控制你正在用的浏览器 这个方法就像给你的浏览器装上一个“对讲机”，让 openclaw 命令能和你正在看的浏览器说话。但需要你先手动安装一个“对讲机”（Chrome 扩展）。

  1. 先安装这个扩展的文件：openclaw browser extension install
  2. 看看扩展文件被放在电脑的哪个文件夹了：openclaw browser extension path
  3. 打开你的 Chrome 浏览器，在地址栏输入 chrome://extensions 并回车。
  4. 打开右上角的“开发者模式”开关。
  5. 点击“加载已解压的扩展程序”按钮。
  6. 选择刚才 path 命令告诉你的那个文件夹。 完成啦！现在你可以在浏览器里点击扩展的图标来连接了。更详细的步骤可以看专门的说明书。

控制另一台电脑上的浏览器 如果控制中心（Gateway）在一台电脑上，而浏览器在另一台电脑上，你需要在有浏览器的那台电脑上运行一个“小帮手”（node host）。这样，控制中心就能通过“小帮手”来遥控那台电脑的浏览器了。你可以在控制中心的设置里决定怎么找到和使用这个“小帮手”。

要小心的事情

  • 用 chrome 这个“身份”时，它控制的是你真实在用的浏览器，操作时要留意。
  • 安装 Chrome 扩展时，一定要从官方指南里说的安全地方获取。
  • 控制远程电脑的浏览器时，要确保网络是安全的，就像锁好门一样。