要让OpenClaw具备浏览器操作能力，核心是选择合适的浏览器模式（托管/扩展中继）并配置对应参数。以下是2026年最新的完整配置指南，覆盖环境准备、模式选择、详细步骤、验证方法，适合新手快速上手：

一、核心概念：OpenClaw的两种浏览器模式

OpenClaw支持两种浏览器控制模式，需根据使用场景选择（选对模式能节省80%的配置时间）：

模式	核心定义	优势	劣势	适用场景
托管浏览器（openclaw模式）	启动独立隔离的Chromium实例（数据目录与个人浏览器完全分离）	安全（不影响个人数据）、稳定（独立调试端口）、支持无头模式（服务器用）	需要手动登录网站（不共享本地登录态）	自动化测试、公开网页抓取、无需登录的任务（如查天气、搜新闻）
扩展中继（user模式）	通过Chrome扩展控制现有Chrome标签页（共享个人登录态、Cookie）	无需重新登录（直接用已登录的Gmail/淘宝/公司内网）、操作无感知	需要安装扩展、可能访问个人数据（需信任AI）	需要登录的后台操作（如批量改数据、填表单）、需要保留会话的任务

二、环境准备（必做）

无论选择哪种模式，都需要先完成以下准备：

1. 安装OpenClaw

# 全局安装（需要Node.js 22+）
npm install -g openclaw@latest

# 验证安装（输出2026.3.2或更高版本）
openclaw --version

2. 初始化配置

# 交互式配置向导（自动生成配置文件）
openclaw onboard --install-daemon

# 启动Gateway（网关服务，默认端口18789）
openclaw gateway --port 18789

三、模式1：托管浏览器（openclaw模式，推荐新手）

目标：让OpenClaw启动独立隔离的浏览器，用于自动化任务（如抓取公开数据、测试网页）。

详细步骤：

1. 修改配置文件（~/.openclaw/openclaw.json）

将默认模式切换为openclaw（托管浏览器），并配置浏览器路径（可选，自动检测即可）：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw",  // 核心：使用托管浏览器模式
    "executablePath": "/usr/bin/google-chrome"  // 可选：指定Chrome路径（自动检测时可省略）
  }
}

2. 安装Playwright（支持高级操作，如点击、输入）

npx playwright install chromium  # 安装Chromium浏览器（OpenClaw依赖）

3. 启动托管浏览器

# 启动浏览器（--profile openclaw可省略，因为defaultProfile已设置）
openclaw browser start --profile openclaw

4. 验证配置

# 查看浏览器状态（应显示running: true）
openclaw browser status --profile openclaw

# 打开指定网页（如百度）
openclaw browser open https://www.baidu.com --profile openclaw

# 截图（验证是否能正常渲染页面）
openclaw browser screenshot --profile openclaw

四、模式2：扩展中继（user模式，适合需要登录的任务）

目标：让OpenClaw通过Chrome扩展控制现有Chrome标签页（共享登录态，无需重新登录）。

详细步骤：

1. 安装Chrome扩展

• 打开Chrome应用商店，搜索**“OpenClaw Browser Relay”**（或访问https://chromewebstore.google.com/detail/openclaw-browser-relay），安装并固定到工具栏。

2. 修改配置文件（~/.openclaw/openclaw.json）

添加user模式配置（连接现有Chrome会话）：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "user",  // 核心：使用扩展中继模式
    "profiles": {
      "user": {
        "driver": "existing-session",  // 用CDP连接现有会话
        "attachOnly": true,  // 只连接已打开的Chrome，不启动新浏览器
        "color": "#00AA00"  // 浏览器窗口边框颜色（可选）
      }
    }
  }
}

3. 启动扩展中继

# 启动连接（--profile user可省略，因为defaultProfile已设置）
openclaw browser start --profile user

4. 验证配置

# 查看连接状态（应显示running: true）
openclaw browser status --profile user

# 列出Chrome中的标签页（应显示你正在打开的页面）
openclaw browser tabs --profile user

# 让AI操作标签页（如在百度搜索“OpenClaw”）
openclaw browser --profile user execute "在百度搜索框输入'OpenClaw'，点击搜索按钮"

五、关键配置说明（必看）

1. 配置文件路径

所有浏览器配置都在~/.openclaw/openclaw.json中（Windows系统为C:\Users\用户名\.openclaw\openclaw.json）。

2. 核心参数解释

• browser.enabled：是否启用浏览器功能（默认true，无需修改）。
• browser.defaultProfile：默认使用的浏览器模式（openclaw/user）。
• profiles.[profileName].driver：浏览器驱动类型（existing-session表示连接现有会话，managed表示托管浏览器）。
• profiles.[profileName].attachOnly：是否只连接已打开的浏览器（true表示不启动新浏览器，false表示可以启动新浏览器）。

3. 安全配置（可选）

为了提升安全性，可以添加SSRF防护（防止恶意访问内网）：

{
  "browser": {
    "ssrfPolicy": {
      "dangerouslyAllowPrivateNetwork": false  // 禁止访问私有网络（如192.168.x.x）
    }
  }
}

六、常见问题排查

现象	原因	解决方案
Browser disabled	配置文件中browser.enabled为false	修改为true并重启Gateway
Running: false	浏览器未启动或路径错误	执行openclaw browser start，检查executablePath
Cannot connect to Chrome	扩展未安装或未附加标签页	重新安装扩展，点击扩展图标附加标签页
中文显示为方块	服务器缺少中文字体	安装fonts-noto-cjk和fonts-wqy-zenhei

七、总结

• 新手推荐：先使用托管浏览器（openclaw模式），熟悉后再尝试扩展中继（user模式）。
• 配置关键：选择正确的defaultProfile（openclaw/user），并确保浏览器路径正确。
• 安全注意：user模式会暴露个人登录态，建议使用专门的Chrome配置文件（仅登录需要AI操作的网站）。

通过以上步骤，你可以让OpenClaw具备浏览器操作能力，实现自动化查快递、填表单、抓数据等任务。如果遇到问题，可以参考OpenClaw官方文档（https://openclaw.ai/docs）或在社区提问。