适用于 Openclaw 的 playwright-cli

一个全面的 Playwright 命令行界面,可实现无缝的浏览器交互、状态管理和自动化网页测试。

lushi516
v0.1.9
2026年4月30日
0
889
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install microsoft-playwright-cli

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 microsoft-playwright-cli。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 playwright-cli?

playwright-cli 是一款强大的浏览器自动化工具,专为需要在终端或自动化工作流中直接与网页交互的开发者设计。作为 Openclaw Skills 集合的一部分,它提供了对 Playwright 库的高级抽象,允许在不编写完整脚本的情况下快速执行点击、输入和表单提交等复杂的浏览器任务。

该技能在处理现代 Web 技术方面特别有价值,提供了快照生成、网络请求模拟和多标签页管理等功能。它缩小了手动浏览与大规模自动化测试之间的差距,成为任何利用 Openclaw Skills 进行网页研究或前端开发的人员的必备工具。

playwright-cli 应用场景

  • 自动化重复的表单提交和数据录入任务。
  • 生成并检查 UI 快照以验证页面布局。
  • 在无头或有头浏览器中调试网络请求和控制台日志。
  • 以编程方式捕获网页内容的高质量屏幕截图和 PDF。
  • 通过保存和加载浏览器 cookies 和 localStorage 来管理复杂的身份验证状态。

playwright-cli 工作原理

  1. 使用 open 或 attach 命令启动浏览器实例以开启会话。
  2. 使用来自快照的简化元素引用,执行 goto、click 或 fill 等交互命令。
  3. 通过提供基于 YAML 的 DOM 表示形式的自动或手动快照来分析页面状态。
  4. 使用针对标签页、存储状态和网络路由的专用命令来管理环境。
  5. 终止会话或保存持久状态以备将来的自动化任务使用。

playwright-cli 配置指南

要开始使用此技能,请通过 npx 检查命令是否可用,或使用 npm 全局安装:

# Check for local version
npx --no-install playwright-cli --version

# Global installation
npm install -g @playwright/cli@latest

playwright-cli 数据架构与分类体系

该技能通过结构化目录和特定文件类型管理浏览器数据和快照:

数据类型 格式 描述
Snapshots .yml 包含页面结构和元素引用(例如 e1, e2)的 YAML 文件。
Auth State .json 用于持久化会话的 cookies 和 localStorage 存储。
Media .png / .pdf screenshot 和 pdf 命令的视觉输出。
Tracing .zip 用于深度调试交互的 Playwright 追踪文件。

playwright-cli 高级特性

  • 命名会话:使用 -s 标志同时运行多个隔离的浏览器实例。
  • 请求模拟:使用自定义状态码和正文拦截并修改网络流量。
  • JavaScript 执行:使用 eval 和 run-code 命令直接在页面上下文中执行自定义脚本。
  • 可视化调试:利用 show --annotate 功能交互式地突出显示并标记 UI 元素以获得更好的上下文。
  • CDP 集成:通过 Chrome DevTools Protocol 连接到现有的 Chrome 或 Edge 实例。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*