Playwright 网页自动化工具

Dev Tools

使用 Playwright 对本地网页、静态 HTML 或在线页面执行自动化测试、元素发现、控制台日志采集与截图。

Install

openclaw skills install playwright-web-test

Playwright Web Test

这是一个面向 ClawHub / OpenClaw 的网页自动化技能,适合以下场景:

  • 打开网页并截图
  • 自动发现按钮、链接、输入框等元素
  • 采集浏览器 console 日志
  • 测试本地静态 HTML 文件
  • 在启动本地服务后执行自动化脚本

推荐触发方式

你可以直接对 agent 说:

  • 打开 http://localhost:5173 并截图
  • 分析这个页面上有哪些按钮和输入框:http://localhost:3000
  • 访问 file:///tmp/demo.html,点击按钮后截图
  • 采集 http://localhost:5173 的 console 日志

目录说明

  • agents/main/agent.yaml:技能入口
  • scripts/run_task.py:统一执行入口
  • scripts/with_server.py:先启动服务再执行自动化
  • examples/:示例脚本

使用建议

  1. 动态页面先等待 networkidle
  2. 优先先做元素发现,再编写精确操作
  3. 需要启动本地服务时,优先使用 with_server.py
  4. 截图输出会使用 MEDIA: 规范,便于网关直接展示

注意事项

  • 需要本地 Python 环境可用
  • 首次运行前需安装 Playwright: python3 -m pip install playwright && python3 -m playwright install chromium
  • 如果目标页面依赖本地服务,请确认端口可访问