Browser 登录（站点登录与 X/Twitter 操作）

概述

Agent 浏览器自动化中的登录最佳实践。核心原则：手动登录，不要将凭据提供给模型。自动登录容易触发反机器人检测并锁定账号。

核心功能

• 推荐登录方式：在 openclaw 浏览器 profile 中手动登录，Agent 复用已登录会话
• Profile 选择：
  • 默认：Agent 使用隔离的 openclaw 浏览器
  • profile="user"：仅在需要已登录会话且用户在场时使用
• X/Twitter 操作：读取/搜索/发帖均推荐使用宿主机浏览器（手动登录），沙箱浏览器更易触发 bot 检测

两种访问 openclaw 浏览器的方式：

1. 让 Agent 打开浏览器，然后手动登录
2. 通过 CLI 直接打开：

openclaw browser start
openclaw browser open https://x.com

配置/权限

沙箱 Agent 访问宿主机浏览器（用于 X/Twitter 等严格站点）：

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

然后通过 CLI 打开宿主机浏览器：

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

相关页面

• tool-browser — 浏览器工具概述
• tool-browser-linux-troubleshooting — Linux 故障排查
• tool-browser-wsl2-troubleshooting — WSL2/Windows 故障排查