適用於 Openclaw 的 playwright-cli

一個全面的 Playwright 命令列介面,可實現無縫的瀏覽器互動、狀態管理和自動化網頁測試。

lushi516
v0.1.9
Apr 30, 2026
0
861
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

精選*