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

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

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

关联参考: https://docs.openclaw.ai/cli/browser, https://docs.browser-use.com/open-source/browser-use-cli, https://github.com/browser-use/browser-use

[toc]

概述

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 ![xiaohongshu-2025-birth-data-2026-04-12](xiaohongshu-2025-birth-data-2026-04-12.md) --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 云服务（需 API Key）
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 browser 命令缺失

原因：浏览器插件未启用或 OpenClaw 版本过低

解决：

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

❌ Browser Use CLI 2 连接失败

原因：Python 环境问题或 PATH 未更新

解决：

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 原生浏览器
需要反检测、CAPTCHA 破解	→ Browser Use CLI 2 云浏览器
高频率快速操作（>100ms）	→ Browser Use CLI 2（~50ms 延迟）
Python 脚本整合	→ Browser Use CLI 2
多会话隔离	✅ 两者均可（OpenClaw 更简单）

建议：大多数 OpenClaw 用户使用原生 openclaw browser 命令即可满足需求。只有在需要云代理、反检测或高级脚本能力时，才考虑集成 Browser Use CLI 2。

关键要点

1. OpenClaw 原生浏览器最适合常规使用，无需额外依赖
2. Browser Use CLI 2优势在云浏览器和速度，适合专业自动化场景
3. 两种方式都可以与 OpenClaw 的 MCP 和 Agent 系统协作
4. 按需选择：简单任务用原生，复杂/持续性任务用 CLI 2