内置工具

浏览器登录

手动登录(推荐)

当网站要求登录时,请在宿主浏览器的 openclaw 配置文件中手动登录。不要向模型提供你的凭据:自动登录通常会 触发反机器人防御机制,并可能锁定账户。

对于 X/Twitter 和其他对机器人敏感的网站,无论是读取内容(搜索/帖子串)还是 发布内容,都请使用宿主浏览器(手动登录)。沙箱隔离的浏览器会话 更容易触发机器人检测。

返回浏览器主文档:浏览器

使用哪个 Chrome 配置文件?

OpenClaw 控制一个名为 openclaw 的专用 Chrome 配置文件(界面呈橙色调), 它与你的日常浏览器配置文件相互独立。

对于智能体浏览器工具调用:

  • 默认选择:智能体使用其隔离的 openclaw 浏览器。
  • 仅当需要使用现有的已登录会话,并且你就在计算机旁、可以点击/批准任何附加提示时, 才使用 profile="user"
  • 如果你有多个用户浏览器配置文件,请明确指定配置文件, 不要猜测。

有两种方式访问 openclaw 配置文件:

  1. 让智能体打开浏览器,然后由你自行登录。
  2. 通过 CLI 打开:
bash
openclaw browser startopenclaw browser open https://x.com

对于非默认配置文件,请将 --browser-profile <name> 放在 子命令之前(默认值为 openclaw):

bash
openclaw browser --browser-profile <name> open https://x.com

沙箱隔离:允许访问宿主浏览器

如果智能体处于沙箱隔离环境,其 browser 工具调用默认使用沙箱 浏览器,而不是宿主浏览器。要让智能体改为使用宿主浏览器:

json5
{  agents: {    defaults: {      sandbox: {        mode: "non-main",        browser: {          allowHostControl: true,        },      },    },  },}

CLI 调用始终使用宿主浏览器,而不会使用沙箱,因此无论此设置如何,你都可以 自行打开宿主浏览器:

bash
openclaw browser --browser-profile openclaw open https://x.com

设置 sandbox.browser.allowHostControl: true 后,智能体的 browser 工具调用也可以使用宿主浏览器。或者,也可以为发布更新的 智能体禁用沙箱隔离。

相关内容

Was this useful?
On this page

On this page