本指南由 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 | bashWindows(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 命令不存在:
- 检查
~/.openclaw/openclaw.json中的plugins.allow是否包含"browser" - 重启 OpenClaw 服务
- 确保 OpenClaw 版本为 2026.2.6-3 或更高
Browser Use CLI 2 连接失败
- 检查 Python 版本(需 3.11+)
- 确保安装了 Git for Windows(Windows 用户)
- 运行
browser-use doctor检查安装状态 - 重启系统以确保环境变量生效
云浏览器代理配置
# 指定国家代理
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。