Browser Use Local_开发编程 skill-PHP中文网

Browser Use Local

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过 browser-use CLI/Python 本地自动化浏览器操作：打开页面、点击输入、截图、提取HTML/链接、调试会话及捕获登录二维码。

浏览器使用( 本地) 播放本

功能概述

浏览器使用( 本地) 播放本是一项面向实际任务的技能，主要用于保护此环境中的默认限制；优先使用浏览器使用( CNI/ Python) , 而不是这里的 OpenClaw 浏览器工具；

核心要点

OpenClaw 浏览器如果没有支持的系统浏览器, 可能会失败。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

browser-use（本地）操作手册

此环境中的默认约束条件

优先使用 browser-use（CLI/Python），而非 OpenClaw 的 browser 工具；若系统中未安装受支持的浏览器，OpenClaw browser 可能失败。
使用 持久化会话（persistent sessions） 执行多步骤操作：--session 。

快速 CLI 工作流（非 Agent 模式）

打开页面

browser-use --session demo open https://example.com

检查页面状态（在重型页面或含大量 JS 的页面上，state 有时返回 0 个元素）

browser-use --session demo --json state | jq '.data | {url,title,elements:(.elements|length)}'

截图（始终可用；是最基础、最可靠的调试手段）

browser-use --session demo screenshot /home/node/.openclaw/workspace/page.png

提取 HTML 内容用于链接发现（即使 state 返回空结果也有效）

browser-use --session demo --json get html > /tmp/page_html.json
python3 - <<'PY'
import json,re
html=json.load(open('/tmp/page_html.json')).get('data',{}).get('html','')
urls=set(re.findall(r"https?://[^s"'<>]+", html))
for u in sorted([u for u in urls if any(k in u for k in ['demo','login','console','qr','qrcode'])])[:200]:
    print(u)
PY

通过 JavaScript 执行轻量级 DOM 查询（当 state 为空时尤为有用）

browser-use --session demo --json eval "location.href"
browser-use --session demo --json eval "document.title"

使用兼容 OpenAI 的大语言模型（Moonshot/Kimi）的 Agent 工作流

当 CLI 的 run 路径需要 Browser-Use 云密钥，或你需要对 LLM 参数进行严格控制时，请使用 Python 启动 Agent。

最小可运行 Kimi 示例

创建 .env 文件（或导出环境变量），内容如下：

OPENAI_API_KEY=...
OPENAI_BASE_URL=https://api.moonshot.cn/v1

然后运行预置脚本：

source /home/node/.openclaw/workspace/.venv-browser-use/bin/activate
python /home/node/.openclaw/workspace/skills/browser-use-local/scripts/run_agent_kimi.py

Kimi/Moonshot 在实际使用中观察到的特殊行为（及其修复方式）：

temperature 必须设为 1（针对 kimi-k2.5）。
frequency_penalty 必须设为 0（针对 kimi-k2.5）。
Moonshot 可能拒绝结构化输出中使用的严格 JSON Schema。请启用以下选项：
- remove_defaults_from_schema=True
- remove_min_items_from_schema=True

若收到包含 response_format.json_schema ... keyword 'default' is not allowed 或 min_items unsupported 的 400 错误，应首先设置上述两个标志。

二维码提取（登录页/演示页）

裁剪候选区域

使用 scripts/crop_candidates.py 从一张截图中生成多个可能包含二维码的裁剪区域。

source /home/node/.openclaw/workspace/.venv-browser-use/bin/activate
python skills/browser-use-local/scripts/crop_candidates.py 
  --in /home/node/.openclaw/workspace/login.png 
  --outdir /home/node/.openclaw/workspace/qr_crops

从 HTML 中提取内嵌的 Base64 图像

source /home/node/.openclaw/workspace/.venv-browser-use/bin/activate
browser-use --session demo --json get html > /tmp/page_html.json
python skills/browser-use-local/scripts/extract_data_images.py 
  --in /tmp/page_html.json 
  --outdir /home/node/.openclaw/workspace/data_imgs

故障排查

state 显示 elements: 0：改用 get html + 正则表达式提取链接，并辅以截图；也可使用 eval 直接查询 DOM。
页面就绪超时警告（Page readiness timeout warnings）：通常无害；建议依赖截图与 HTML 内容进行判断。
CLI 参数顺序：全局参数必须置于子命令之前：
- ✅ 正确：browser-use --browser chromium --json open https://...
- ❌ 错误：browser-use open https://... --browser chromium