本指南由 AI 辅助生成,内容基于实际测试验证。

OpenClaw 接入 Browser Use CLI 2 的完整指南

整合 Browser Use CLI 2 与 OpenClaw,实现强大的浏览器自动化能力

概述

Browser Use CLI 2 是专为 AI 编程代理设计的最快浏览器自动化工具,通过直接 Chrome DevTools Protocol (CDP) 实现约 50ms 命令延迟。与 OpenClaw 集成后,可以实现:

  • 2x 速度提升,50% 减少 token 消耗
  • 支持任何 CLI 代理(Claude Code、Codex 等)
  • 持久后台守护进程保持浏览器常驻
  • 云浏览器支持(195+ 国家代理、反检测配置)

集成方式

方式一:通过 OpenClaw 插件集成(推荐)

OpenClaw 原生支持浏览器控制,通过 openclaw browser CLI 命令管理浏览器生命周期。

安装浏览器插件

检查 ~/.openclaw/openclaw.json 配置,确保浏览器插件已启用:

{
  "plugins": {
    "allow": ["telegram", "browser"]
  }
}

基本操作流程

# 查看可用浏览器配置文件
openclaw browser profiles
 
# 启动 OpenClaw 专用浏览器(隔离用户数据)
openclaw browser --browser-profile openclaw start
 
# 导航到网页
openclaw browser --browser-profile openclaw open https://example.com
 
# 获取页面状态(获取可点击元素索引)
openclaw browser --browser-profile openclaw snapshot
 
# 截图
openclaw browser --browser-profile openclaw screenshot
 
# 关闭浏览器
openclaw browser stop

方式二:通过 Browser Use CLI 2 作为外部工具集成

安装 Browser Use CLI 2

macOS/Linux:

curl -fsSL https://browser-use.com/cli/install.sh | bash

Windows(PowerShell):

& "C:\Program Files\Git\bin\bash.exe" -c 'curl -fsSL https://browser-use.com/cli/install.sh | bash'

安装 OpenClaw Skill

npx skills add https://github.com/browser-use/browser-use --skill browser-use

配置 OpenClaw 调用 Browser Use CLI 2

在 OpenClaw 中创建自定义工具调用:

{
  "tool": "exec",
  "command": "browser-use open {{url}}",
  "description": "使用 Browser Use CLI 2 打开指定网页"
}

完整集成工作流示例

# 1. 启动 Browser Use CLI 2 守护进程
browser-use open https://example.com
 
# 2. 获取页面状态
browser-use state
 
# 3. 通过 OpenClaw 调用浏览器自动化任务
openclaw browser --browser-profile openclaw click 5
 
# 4. 在 OpenClaw 代理中整合浏览器操作
{
  "action": "exec",
  "command": "browser-use type \"Hello World\""
}

核心功能对比

功能OpenClaw 原生浏览器Browser Use CLI 2
命令延迟100-300ms~50ms
多会话支持✔️✔️(通过 —session)
云浏览器通过 node host✔️(原生支持)
反检测配置需手动配置✔️(内置)
CAPTCHA 解决需外部服务✔️(内置)
Python 脚本支持✔️(browser-use python)
MCP 服务器✔️(OpenClaw 内置)✔️(内置)
状态同步✔️(通过 snapshot)✔️(通过 state)

高级配置

使用云浏览器

# 1. 登录 Browser Use 云服务
browser-use cloud login <your-api-key>
 
# 2. 创建云浏览器会话
browser-use cloud connect --proxy-country US
 
# 3. 通过 OpenClaw 控制云浏览器
openclaw browser --browser-profile openclaw open https://example.com
 
# 4. 从 OpenClaw 发送浏览器操作
{
  "action": "exec",
  "command": "browser-use click 5"
}

持久会话管理

# 创建命名会话
browser-use --session work open https://work.example.com
 
# 在 OpenClaw 中调用特定会话
{
  "action": "exec",
  "command": "browser-use --session work state"
}
 
# 查看所有会话
browser-use sessions

故障排除

OpenClaw 浏览器命令缺失

如果 openclaw browser 命令不存在:

  1. 检查 ~/.openclaw/openclaw.json 中的 plugins.allow 是否包含 "browser"
  2. 重启 OpenClaw 服务
  3. 确保 OpenClaw 版本为 2026.2.6-3 或更高

Browser Use CLI 2 连接失败

  1. 检查 Python 版本(需 3.11+)
  2. 确保安装了 Git for Windows(Windows 用户)
  3. 运行 browser-use doctor 检查安装状态
  4. 重启系统以确保环境变量生效

云浏览器代理配置

# 指定国家代理
browser-use cloud connect --proxy-country US
 
# 指定特定配置文件
browser-use cloud connect --profile-id <profile-id>
 
# 设置超时
browser-use cloud connect --timeout 120

总结

推荐使用 方式一:OpenClaw 原生浏览器集成,因为:

  • 无需额外安装依赖
  • 与 OpenClaw 生态深度集成
  • 更好的安全隔离
  • 与 OpenClaw 的其他工具(如 MCP、Agent)无缝协作

Browser Use CLI 2 适合需要:

  • 云浏览器代理
  • 反检测功能
  • 高级脚本能力
  • 与非 OpenClaw AI 代理集成

的场景。

最佳实践:对于大多数 OpenClaw 用户,使用原生 openclaw browser 命令即可满足需求。只有在需要云代理、反检测或特定功能时,才考虑集成 Browser Use CLI 2。