跳转至

浏览器登录

当网站需要登录时，请在宿主浏览器的 openclaw 配置文件中手动登录。自动登录通常会触发反机器人防御，并可能导致账户被锁定。

对于所有者授权的任务，代理可以通过浏览器表单填写使用所有者提供的凭据。请勿将凭据留在聊天和回复中。

对于 X/Twitter 和其他对机器人敏感的网站，无论是阅读（搜索/帖子）还是发帖，都请使用宿主浏览器（手动登录）。沙盒浏览器会话更容易触发机器人检测。

返回主浏览器文档：浏览器。

使用哪个 Chrome 配置文件？

OpenClaw 控制一个名为 openclaw 的专用 Chrome 配置文件（橙色色调 UI），与您的日常浏览器配置文件分开。

对于代理浏览器工具调用：

  • 默认选择：代理使用其隔离的 openclaw 浏览器。
  • 仅当现有已登录会话很重要，并且您在计算机旁可以点击/批准任何附加提示时，才使用 profile="user"。
  • 如果您有多个用户浏览器配置文件，请明确指定配置文件，而不是猜测。

访问 openclaw 配置文件的两种方式：

  1. 让代理打开浏览器，然后您自己登录。
  2. 通过 CLI 打开：
openclaw browser start
openclaw browser open https://x.com

对于非默认配置文件，在子命令之前放置 --browser-profile <name>（默认是 openclaw）：

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

沙盒：允许访问宿主浏览器

如果代理被沙盒化，其 browser 工具调用默认指向沙盒 浏览器，而不是宿主。要让代理改为指向宿主浏览器：

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

CLI 调用始终指向宿主浏览器，从不指向沙盒，因此无论此设置如何，您都可以自己打开宿主浏览器：

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

一旦设置 sandbox.browser.allowHostControl: true，代理的 browser 工具调用也可以指向宿主。或者，为负责发布更新的代理禁用沙盒。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw