browser-use-local

🌐 本地浏览器自动化与 AI Agent 控制器

基于 browser-use 的本地浏览器自动化方案,支持 CLI 操作与 Moonshot/Kimi Agent 任务,提供二维码提取与会话管理。

收藏
14.5k
安装
3.4k
版本
v1.0.0
CLS 安全性认证2026-05-03
点击查看完整报告 >

使用说明

该 Skill 提供了基于 browser-use 框架的本地浏览器自动化能力,专为 OpenClaw 容器/主机环境设计,支持通过 CLI 命令或 Python Agent 代码实现网页打开、元素操作、截图、HTML 提取等全流程浏览器控制。区别于依赖系统浏览器的传统方案,该工具采用独立的 browser-use 运行时,在无桌面环境的容器中也能稳定工作。

核心用法分为两条路径:一是 CLI 快速工作流,通过 --session 建立持久化会话,使用 openstatescreenshotget html 等子命令完成单步操作,适合快速调试和确定性任务;二是 Agent 智能工作流,通过 Python 脚本调用 browser-use 的 Agent 类,结合 OpenAI 兼容 API(如 Moonshot/Kimi)实现自然语言驱动的自主浏览器任务,支持自动处理页面跳转、表单填写等复杂流程。

显著优点包括:完全本地执行确保数据隐私,敏感操作无需上传至第三方浏览器云服务;深度适配国产大模型生态,针对 Kimi-k2.5 的特殊参数要求(temperature=1、frequency_penalty=0)提供了开箱即用的配置方案;专业的二维码提取能力,支持从截图裁剪和 HTML base64 数据源双重解码;丰富的调试手段,当 state 命令在 JavaScript 重载页面失效时,可通过 eval 执行 JavaScript 或分析 HTML 源码继续工作。

潜在局限性主要体现在:依赖管理方面未提供 requirements.txt 等锁定文件,用户需自行确保 browser-use、Pillow、python-dotenv 等依赖版本兼容;来源为 T3 级社区个人开发者,虽代码通过安全审计,但长期维护稳定性需观察;state 命令在复杂动态页面可能返回空元素列表,需要配合截图和 HTML 分析使用。

适合目标群体包括:需要浏览器自动化测试的开发者、构建 RPA 流程的运维人员、使用 Moonshot/Kimi 等国产 LLM 构建浏览器 Agent 的 AI 应用开发者,以及需要从登录页提取二维码进行扫码认证的场景。

使用风险主要涉及:依赖版本冲突可能导致功能异常,建议在虚拟环境中运行;Agent 模式需要配置有效的 API Key 和 Base URL,错误配置可能导致请求失败;页面 readiness 超时警告在复杂页面常见,通常不影响实际功能,但需通过截图验证页面状态;多步骤流程建议始终使用 --session 保持会话状态,避免 Cookie 丢失导致流程中断。

安全解读

核心用法

browser-use-local 是一款专为 OpenClaw 容器/主机环境设计的浏览器自动化技能,提供 CLI 和 Python 两种调用方式。核心能力包括:

基础浏览器操作:通过 browser-use --session <name> 建立持久化会话,执行页面打开、点击、输入、截图、HTML提取等操作。支持 --json 输出便于脚本化处理。

智能 Agent 工作流:内置对 Moonshot/Kimi 等 OpenAI 兼容 LLM 的支持,通过自定义 base_url 实现本地或私有化部署。Python 脚本封装了 Kimi 特有的参数调优(temperature=1、frequency_penalty=0、禁用 schema defaults)。

QR 码提取专精:针对登录/演示页面的二维码场景,提供截图区域裁剪(crop_candidates.py)和 HTML 内嵌 base64 图片提取(extract_data_images.py)两套方案。

显著优点

  • 环境适配性强:专为容器/无系统浏览器环境优化,避免 OpenClaw 原生 browser 工具失效问题
  • 持久化会话:多步骤流程无需重复初始化,状态可复用
  • 调试友好:截图作为最可靠的调试原语,即使 state 返回空元素也能通过 HTML+正则继续工作
  • LLM 生态开放:不绑定单一供应商,任何 OpenAI 兼容端点均可接入

潜在局限性

  • JS 重站兼容性:动态渲染页面可能出现 state 空元素,需降级到 HTML 提取或截图分析
  • 外部 API 依赖:Agent 模式必须配置外部 LLM,无法完全离线运行
  • 权限要求:浏览器进程启动和网络访问需要适当系统权限,容器环境可能需额外配置

适合人群

  • 需要在受限环境(容器、无 GUI 服务器)进行浏览器自动化的开发者
  • 使用 Moonshot/Kimi 等国产 LLM 构建 Web Agent 的 AI 应用开发者
  • 需要自动化处理登录二维码、提取页面信息的运维/测试工程师

常规风险

1. 数据外泄风险:页面内容(可能含敏感信息)会被发送到第三方 LLM,建议生产环境评估脱敏需求或改用本地 LLM
2. API 端点可信度:用户自定义 OPENAI_BASE_URL 时,需确保 endpoint 安全可信

3. 浏览器权限:自动化操作需确保目标网站访问合规,避免违反服务条款

browser-use-local 内容

scripts文件夹
手动下载zip · 4.3 kB
crop_candidates.pytext/plain
请选择文件