# 浏览器登录

> 浏览器自动化和 X/Twitter 发帖的手动登录

- 网址：https://funcoding.ai/agents/openclaw/tools/browser-login/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/tools/browser-login

---
## 手动登录（推荐）

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

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

返回浏览器主文档：[浏览器](https://funcoding.ai/agents/openclaw/tools/browser/)。

## 使用哪个 Chrome 配置文件？

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

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

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

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

1. 让智能体打开浏览器，然后由你自行登录。
2. 通过 CLI 打开：

```bash
openclaw browser start
openclaw 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`
工具调用也可以使用宿主浏览器。或者，也可以为发布更新的
智能体禁用沙箱隔离。

## 相关内容

- [浏览器](https://funcoding.ai/agents/openclaw/tools/browser/)
- [浏览器 Linux 故障排查](https://funcoding.ai/agents/openclaw/tools/browser-linux-troubleshooting/)
- [浏览器 WSL2 故障排查](https://funcoding.ai/agents/openclaw/tools/browser-wsl2-windows-remote-cdp-troubleshooting/)