Playwright Controller für Openclaw

Eine leistungsstarke Funktion zum Surfen im Web und zur Datenextraktion, die es KI-Agenten ermöglicht, Screenshots und Texte über Playwright zu erfassen.

mrchenkuan
v1.0.0
Mar 1, 2026
0
1.2k
0

Installieren & Herunterladen

1. ClawHub CLI

Der schnellste Weg, einen Skill direkt aus der Registry zu installieren.

npx clawhub@latest install playwright-controller

2. Manuelle Installation

Kopiere den Skill-Ordner an einen dieser Orte

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priorität: Workspace > Lokal > Integriert (Bundled)

3. Prompt-Installation

Kopiere diesen Prompt in OpenClaw, um ihn automatisch zu installieren.

Hilf mir, playwright-controller über Clawhub zu installieren. Falls Clawhub nicht installiert ist, installiere es bitte zuerst (npm i -g clawhub).

Lieber herunterladen?

Hole dir die rohen Skill-Dateien in einem ZIP-Archiv.

Was ist Playwright Controller?

Der Playwright Controller ist ein Browser-Automatisierungstool für Profis, das für das Openclaw Skills-Ökosystem entwickelt wurde. Er ermöglicht es Entwicklern und KI-Agenten, das Web programmatisch mit Chromium zu navigieren, und bietet Funktionen wie Ganzseiten-Rendering, Emulation mobiler Geräte und intelligentes Warten auf dynamische Inhalte. Im Gegensatz zu einfachen Scrapern verarbeitet diese Funktion JavaScript-intensive Websites durch Simulation realer Benutzerumgebungen, einschließlich iPhone-Viewports und spezifischer User-Agent-Strings.

Durch die Integration dieser Funktion erhalten Agenten die Möglichkeit, Web-Layouts visuell zu überprüfen und sauberen, strukturierten Text für die weitere Verarbeitung zu extrahieren. Sie unterstützt sowohl den Headless-Modus für Geschwindigkeit als auch den Headful-Modus für Szenarien, die ein manuelles Eingreifen erfordern, wie komplexe Logins oder die Lösung von CAPTCHAs, was sie zu einer vielseitigen Ergänzung für jeden Automatisierungs-Workflow macht.

Playwright Controller Anwendungsfälle

  • Erstellung von ganzseitigen oder elementspezifischen Screenshots für die visuelle Dokumentation.
  • Extraktion von sauberem Textinhalt aus modernen Webanwendungen durch Entfernen von Skripten und Werbung.
  • Testen der Reaktionsfähigkeit von Websites durch mobile Viewport- und User-Agent-Simulation.
  • Automatisierung der Datenerfassung von Websites, die eine vollständige Browserumgebung zum Rendern von JS-Inhalten erfordern.
  • Debugging von Web-Interaktionen unter Verwendung von Headful-Browser-Modi innerhalb einer KI-gesteuerten Umgebung.

So funktioniert Playwright Controller

  1. Der Agent löst die Funktion mit spezifischen Befehlen wie fetch oder fetch-element aus.
  2. Eine Chromium-Browserinstanz wird mit vorkonfigurierten mobilen Kontexteinstellungen (iPhone-Simulation) gestartet.
  3. Der Controller navigiert zur Ziel-URL und implementiert intelligentes Warten mit dem Status networkidle.
  4. Eine zusätzliche Rendering-Verzögerung wird angewendet, um sicherzustellen, dass alle asynchronen Assets und Schriftarten vollständig geladen sind.
  5. Die Funktion erfasst einen hochauflösenden PNG-Screenshot und extrahiert den inneren Text der Seite.
  6. Nicht wesentliche Elemente wie Skripte und Werbeanzeigen werden während der Textextraktionsphase gefiltert.
  7. Dateien werden in einem vorgesehenen Verzeichnis mit eindeutigen Zeitstempeln und URL-basierten Hashes für eine organisierte Speicherung gespeichert.

Playwright Controller Einrichtung

Der Playwright Controller ist Teil der Openclaw Skills-Bibliothek und wird mit allen erforderlichen, vorkonfigurierten Abhängigkeiten geliefert. Stellen Sie sicher, dass Node.js (v16+) installiert ist.

# Um eine Webseite abzurufen und sofort einen Screenshot zu erstellen
playwright:fetch https://example.com

# Um ein bestimmtes Element auf einer Seite zu erfassen
playwright:fetch-element --selector=".main-content" https://example.com

Playwright Controller Datenschema & Taxonomie

Die Funktion organisiert die Ausgabe in einem strukturierten Verzeichnisformat, normalerweise in einem Ordner ./screenshots. Dateien werden mit einer Kombination aus Zeitstempeln und bereinigten URL-Hashes benannt.

Dateityp Namenskonvention Beschreibung
Vollständiger Screenshot <timestamp>_<url_hash>.png Hochwertige PNG-Erfassung der gesamten Seite.
Extrahierter Text <timestamp>_<url_hash>_content.txt Bereinigter Textinhalt der gesamten Seite.
Element-Visualisierung <timestamp>_<url_hash>_element.png Gezielter Screenshot eines spezifischen CSS-Selektors.
Fehlererfassung <timestamp>_<url_hash>_error.png Visueller Zustand, der während eines Ausführungsfehlers erfasst wurde.

Playwright Controller Erweiterte Funktionen

  • Mobile Emulation: Integrierte Unterstützung für iPhone 17.0 User-Agent und 375x800 Auflösungssimulation.
  • Intelligentes Warten: Automatische Erkennung von Netzwerk-Leerlaufzuständen und benutzerdefinierten Rendering-Puffern.
  • Headful-Modus: Optionales sichtbares Browserfenster für Debugging und manuelle Benutzerinteraktionen.
  • Ressourcen-Interception: Fähigkeit zur Leistungsoptimierung durch Überspringen nicht wesentlicher Assets bei gleichzeitiger Beibehaltung der visuellen Genauigkeit.
  • Flexible API: Direkter Zugriff auf fetchWithPlaywright- und fetchElementAndScreenshot-Funktionen für die Integration benutzerdefinierter Skripte.
  • Robuste Fehlerbehandlung: Automatische Screenshot-Erstellung, selbst wenn das Laden der Seite fehlschlägt, um das Debugging zu erleichtern.

SKILL.md


Laden

Verwandte Openclaw-Skills

METADATA

Github Stars: 0
forks: 0

Hervorgehoben*