OC
OpenClaw 中文解释版

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

简要总结

Browser (OpenClaw-managed)

这页说明书在讲一个叫“OpenClaw浏览器”的小工具。你可以把它想象成给你的智能助手一个它自己专用的、橙色的小浏览器窗口。这个窗口和你平时用的浏览器是分开的，助手可以在里面安全地打开网页、点击按钮和打字，而不会弄乱你的东西。当你需要让助手帮你自动操作网页，或者检查网页内容时，就可以看看这页。

五岁小孩版解释

OpenClaw 可以启动一个专门给智能助手用的浏览器，它就像助手的私人小房间，和你的浏览器是完全分开的。这个小浏览器可以是 Chrome、Brave、Edge 或 Chromium。

快速开始 要使用它，你需要在电脑的命令行里输入一些指令。别担心，指令就像给电脑的“魔法咒语”。

  1. 检查状态：先念咒语 openclaw browser --browser-profile openclaw status，看看助手的小浏览器准备好了没有。
  2. 启动浏览器：如果没启动，就念 openclaw browser --browser-profile openclaw start，把它叫醒。
  3. 打开网页：然后念 openclaw browser --browser-profile openclaw open https://example.com，它就会打开一个网页。
  4. 拍张快照：念 openclaw browser --browser-profile openclaw snapshot，可以给网页拍一张文字照片，助手就能“看到”网页上有什么了。 如果电脑说“浏览器被禁用了”，你需要去一个叫配置文件的地方打开它（下面会讲），然后重启一下 OpenClaw 的“网关”。

两种模式 助手的小浏览器有两种工作方式：

  • openclaw 模式：这是它自己管理的独立浏览器，最安全，不需要安装额外的东西。
  • chrome 模式：这个模式会连接到你电脑上正在用的 Chrome 浏览器的一个标签页，但需要你先安装一个叫“OpenClaw 浏览器中继”的小插件。 你可以设置让助手默认使用 openclaw 模式，这样更省心。

重要设置（在配置文件里） 所有关于浏览器的设置，都写在一个叫 ~/.openclaw/openclaw.json 的文件里。你可以把它想象成给 OpenClaw 的“说明书”。里面有一些重要的词：

  • enabled: true：意思是“允许使用浏览器功能”。
  • defaultProfile: “openclaw”：意思是“助手默认使用它自己的独立浏览器”。
  • executablePath：如果你想让助手用特定的浏览器（比如 Brave），就在这里告诉它那个浏览器程序藏在电脑的哪个位置。
  • profiles：这里可以给浏览器起不同的名字，比如“工作用”、“远程用”，每个都可以有不同的设置和颜色。
  • ssrfPolicy：这是一条安全规则，像小区的门卫，决定浏览器能去哪些网站。默认情况下，它允许访问家里的网络（dangerouslyAllowPrivateNetwork: true）。如果你只想让它上公开的网站，就把这里改成 false。

怎么用你喜欢的浏览器（比如 Brave） 如果你的电脑默认浏览器就是 Chrome、Brave 这些，OpenClaw 会自动找到它。如果你想指定一个，就在配置文件里设置 browser.executablePath，就像告诉它：“请用放在 /Applications/Brave Browser.app/... 这里的 Brave 浏览器。”

一些重要的提醒

  • 安全第一：这个浏览器是给助手自动化操作用的，不是给你日常上网的。请让 OpenClaw 的“网关”和“节点主机”待在安全的家庭网络里，不要暴露在公网上。
  • 小心秘密：如果你设置了连接远程浏览器的地址（cdpUrl），里面可能有密码或令牌，这些就像钥匙，不要直接写在配置文件里，最好用环境变量或秘密管理器来保管。
  • 容易出错的地方：在命令行操作时，如果网页变了，之前拍快照得到的元素编号（ref）可能会失效。如果点击或打字没反应，记得重新拍一张快照 (snapshot)，使用新的编号。
  • 需要额外工具：有些高级功能，比如点击、打字、拍 AI 快照，需要一个叫 Playwright 的工具。如果没安装，这些功能就用不了。如果提示 Playwright 没装，你需要安装完整的 Playwright 包（不是 playwright-core），然后重启网关。

如果助手控制不了你的 Chrome 标签页 如果你想用 chrome 模式（控制你现有的 Chrome 标签页），需要先安装一个浏览器插件：

  1. 在命令行输入 openclaw browser extension install，它会告诉你怎么做。
  2. 打开 Chrome，进入 chrome://extensions 页面。
  3. 打开“开发者模式”。
  4. 点击“加载已解压的扩展程序”，选择上一步命令告诉你的那个文件夹。
  5. 把插件图标固定到工具栏，然后在你想让助手控制的标签页上，点击这个插件图标（图标会显示 ON）。 完成之后，助手就能通过 chrome 模式来控制那个标签页了。