OpenClaw 自动化浏览器配置指南

通过 Chrome DevTools MCP，AI 可以直接控制你已登录的 Chrome 浏览器，无需重新登录即可操作网页。

前置条件

Chrome 浏览器：确保已安装 Google Chrome
OpenClaw 版本：2026.4.10+

配置步骤

第一步：开启 Chrome 远程调试

打开 Chrome，在地址栏输入：chrome://inspect/#remote-debugging
勾选 "Allow remote debugging for this browser instance"
确认显示 Server running at: 127.0.0.1:9222

注意：端口默认为 9222

第二步：修改 OpenClaw 配置

编辑 ~/.openclaw/openclaw.json：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "user",
    "cdpUrl": "http://localhost:9222",
    "ssrfPolicy": {
      "dangerouslyAllowPrivateNetwork": true,
      "hostnameAllowlist": ["*"]
    },
    "profiles": {
      "user": {
        "driver": "existing-session",
        "attachOnly": true,
        "color": "#00AA00"
      }
    }
  },
  "tools": {
    "profile": "full"
  }
}

配置说明：

配置项	说明
`defaultProfile: "user"`	使用 Chrome MCP existing-session 模式
`driver: "existing-session"`	复用已登录的 Chrome 会话
`attachOnly: true`	不启动新浏览器，只附着现有浏览器
`ssrfPolicy.hostnameAllowlist: ["*"]`	允许访问所有域名
`cdpUrl: "http://localhost:9222"`	Chrome 远程调试端口

第三步：重启网关

openclaw gateway restart

第四步：验证配置

openclaw browser status

正常输出：

profile: user
enabled: true
running: true
transport: chrome-mcp
detectedBrowser: chrome

使用方法

在 OpenClaw Dashboard 或 CLI 中直接发送指令：

示例指令：

"打开百度搜索 OpenClaw"
"打开 GitHub 看看 minimax 的仓库"
"获取当前页面的内容"

完整测试：

openclaw agent --agent main --message "打开百度搜索 OpenClaw"

注意事项

安全风险：tools.profile: "full" 允许 AI 执行任意命令，包括文件操作。请仅在个人机器上使用。
浏览器状态：使用 existing-session 模式时，Chrome 必须保持运行状态。
首次连接：首次连接时 Chrome 会弹出授权确认，点击"允许"即可。
SSRF 策略：默认情况下浏览器只能访问 IP 地址。如需开放域名访问，按本文配置设置 hostnameLallowlist: ["*"]。

常见问题

Q: 浏览器显示 "Navigation blocked by policy"
A: 检查 browser.ssrfPolicy.hostnameAllowlist 配置，确保目标域名在白名单中。

Q: openclaw browser status 显示 running: false
A: 确保 Chrome 已开启远程调试，且 cdpUrl 端口与 Chrome 调试端口一致（默认 9222）。

Q: AI 无法执行搜索动作
A: 可能需要先手动在浏览器中打开目标页面，然后让 AI 继续操作。