网页自动化引擎
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-webwright。
技能介绍
点击式自动化为什么不够可靠
逐点击(click-by-click)的浏览器自动化在真实站点面前非常脆弱:DOM 一点小变化、一个弹窗、一段异步加载,都可能让脚本突然失效。涉及登录、跨页状态传递的多步流程(结账向导、多页表单)维护成本更是迅速失控。Webwright 用代码即动作(code-as-action)的思路解决这个问题:LLM 负责编写并执行 Playwright 脚本,驱动真实 Chromium 浏览器,而不是一步步模拟点击。
技能如何工作
- LLM 接收带范围的
-t任务与--start-url,生成一份 Playwright Python 脚本。 - 脚本在真实 Chromium 上运行,动作可重复:生成的
final_script.py作为产物保留,之后可以直接重跑。 - 每次运行产出
plan.md、步骤日志与final_runs/run_*下的截图,出问题时能审计 agent 到底做了什么。 - 支持
-c配置叠加,例如-c agent.step_limit=20可限制 agent 的步骤预算。 - 模型后端可选
model_openai.yaml、model_claude.yaml或model_openrouter.yaml,挑环境中已有对应 API key 的那一个即可。
适用边界与注意点
- 适合多步流程:登录、向导、结账、跨页面传递状态。
- 不适合简单的单页读取或抽取——用
web_fetch或内置网页工具就够了。 - 浏览器会对线上站点执行真实操作并消耗 API token,只应在用户授权的任务与站点上运行。
- 绝不把秘密写进
-t任务文本:任务会发给模型提供商,并记录进运行产物(轨迹、日志、进程参数)。需要登录的任务通过环境变量传凭证,并告知 agent 读取哪些变量名。 -o输出目录必须指向当前 workspace 内部,绝不要写进 OpenClaw 状态目录。
使用场景
- 电商网站结账流程包含优惠券校验、收货地址填写、支付跳转等多个步骤,需要稳定自动完成并生成可复用脚本
- 医院预约系统需要填写多页表单,跨页面传递患者信息,人工操作容易遗漏字段,需要脚本化驱动浏览器完成
- 内部系统登录后要跨多个页面收集报表数据,每步都依赖上一步状态,需要自动化维持会话并导出结果
- 门票预订向导涉及日期选择、人数配置、确认页跳转,需要重复执行且保留截图记录用于问题排查
适合人员
- 电商工程师需要将结账、优惠券、支付流程自动化,并保留可重跑脚本以便后续维护与回归测试
- 测试工程师面对多步表单与登录墙,需要生成稳定可复用的浏览器自动化脚本,减少人工点击测试的重复劳动
- 数据工程师要从内部系统跨页面导出报表,依赖会话状态,希望用代码化方式替代手工复制粘贴
- 爬虫工程师需要驱动真实浏览器绕过简单反爬,并要求每次运行产出日志与截图,便于调试和审计