Diese Seite ist auch auf English verfügbar
ClawHub-Skill

Ein ehrlicher Blick für Ihren OpenClaw-Agent

Ein Agent, der curl aufrufen kann, holt eine URL bereits ab. Was er nicht kann: beurteilen, ob der Abruf überhaupt funktioniert hat. Dieser Skill ergänzt sechs Operationen über die EnConvert-API, und jeder Seitenaufruf liefert einen render_quality-Wert zurück. Eine Bot-Sperre oder eine leere App-Hülle kommt damit markiert an, statt zusammengefasst zu werden, als wäre sie die Seite.

Skill installieren
openclaw skills install @enconvert/enconvert
Dokumentation lesenQuellcode ansehen
Die Lücke

Warum curl allein nicht reicht

OpenClaw-Agents beherrschen Shell-Befehle. Das Web lässt sich damit schlecht lesen. Vier Dinge gehen in der Praxis schief, und der Skill deckt jedes davon ab.

Was scheitertWas der Skill tut

Eine Seite, die per JavaScript rendert

Perceive URL startet einen echten Browser und liefert die fertig geladene Seite als Markdown, nicht die leere Hülle, die curl sieht.

Eine Word-, PowerPoint- oder EPUB-Datei

Convert File to Markdown liest Formate, für die ein Agent keinen Parser hat, und gibt Text zurück, mit dem er arbeiten kann.

Zu wissen, ob ein Abruf geklappt hat

Jeder Seitenaufruf trägt render_quality von 0.0 bis 1.0. Eine Challenge-Seite fällt niedrig aus, sodass der Agent erneut versuchen oder abbrechen kann, statt aus einem Cookie-Banner zu halluzinieren.

Eine ganze Website lesen, nicht eine Seite

Discover URLs listet eine Website per Sitemap oder Crawl auf, sodass der Agent auswählt, statt URLs zu raten.

Operationen

Sechs Operationen, eine Anweisungsdatei

Ein ClawHub-Skill ist eine einzelne Markdown-Datei, die der Agent liest und ausführt. Es gibt keine Laufzeitumgebung zu installieren, kein SDK zu pinnen und kein Tool-Schema zu registrieren. Jede Operation ist ein dokumentierter curl-Aufruf gegen dieselbe REST-API, die jeder andere EnConvert-Client nutzt.

  1. Perceive URL

    Eine Seite als Markdown, HTML, Screenshot, PDF, Links, Bilder oder strukturierte Daten rendern. Artefakte kommen als kurzlebige signierte URLs zurück, strukturierte Daten direkt inline.

    POST /v2/perceive

  2. Web Search

    Web, News, Bilder, Scholar, Patente oder Maps durchsuchen und gerankte Treffer mit Titel, URL und Snippet für den nächsten Schritt erhalten.

    POST /v2/lookup

  3. Discover URLs

    Eine Website per Sitemap, Crawl oder beidem erfassen, mit Include- und Exclude-Mustern, bevor ein einziger Seitenaufruf verbraucht wird.

    POST /v2/discover

  4. Extract Structured

    Ein JSON-Schema oder eine flache Feldliste übergeben und typisierte Daten pro URL zurückbekommen, aus einer Liste oder aus einer Website, die die API für Sie crawlt.

    POST /v2/distill

  5. Convert File to Markdown

    Ein Dokument, eine Tabelle, eine Präsentation, ein PDF oder ein EPUB in sauberes Markdown verwandeln, bereit zum Zusammenfassen oder Einbetten.

    POST /v1/convert/anything-to-markdown

  6. Convert File to PDF

    Ein Dokument, Bild, HTML oder Textdokument nach PDF konvertieren, wenn der Agent einer Person eine echte Datei zurückgeben soll.

    POST /v1/convert/anything-to-pdf
Einrichtung

Ein Befehl und ein Secret

Der Skill liefert keinen Schlüssel mit und ruft nichts außer der EnConvert-API auf. Sie stellen Ihren eigenen privaten Schlüssel bereit, den der Agent aus der Umgebung liest.

Von ClawHub installieren

Führen Sie den Installationsbefehl in Ihrem Agent-Workspace aus. Der Skill ist öffentlich, MIT-0 und erscheint unter dem Publisher @enconvert.

Privaten Schlüssel erstellen

Erzeugen Sie einen Schlüssel im EnConvert-Dashboard. Private Schlüssel beginnen mit sk_. Öffentliche pk_-Schlüssel sind für Browser-Widgets gedacht und werden hier abgelehnt.

Als ENCONVERT_API_KEY bereitstellen

Legen Sie den Schlüssel in die Umgebung, in der der Agent läuft. Der Skill prüft ihn per whoami-Aufruf, bevor er echte Arbeit erledigt, sodass ein falscher Schlüssel sofort scheitert und nicht mitten in einer Aufgabe.

Den Agent einfach fragen

Keine Verkabelung, keine Konfigurationsdatei. Bitten Sie ihn, eine Seite zu lesen, ein Thema zu recherchieren oder eine Datei zu konvertieren, und er wählt die Operation aus den Anweisungen.

Fehlt ENCONVERT_API_KEY oder curl, filtert OpenClaw den Skill beim Laden heraus, und der Agent verhält sich, als wäre er nie installiert worden. Es gibt keine Fehlermeldung zu lesen, prüfen Sie also zuerst beides, wenn der Agent den Skill nicht zu kennen scheint.

In der Praxis

Was Agents damit tatsächlich machen

Vier Aufgaben, die kein Prompt-Engineering brauchen. Der Agent liest den Skill und verkettet die Operationen selbst.

„Lies diese Seite und fasse sie zusammen“

  • Perceive URL

Perceive liefert fertig geladenes Markdown mit Qualitätswert, sodass die Zusammenfassung die Seite betrifft und nicht einen Einwilligungsdialog.

„Recherchiere das Thema und nenne Quellen“

  • Web Search
  • Perceive URL

Die Suche findet Kandidaten, dann liest Perceive die vielversprechenden. Der Agent zitiert URLs, die er tatsächlich gelesen hat.

„Hol die Preise von allen Wettbewerbsseiten“

  • Discover URLs
  • Extract Structured

Discover listet die Website auf, dann liefert Extract typisierte Felder pro URL gegen ein einziges Schema.

„Mach aus diesem Vertrag Notizen“

  • Convert File to Markdown

Convert liest die Word- oder PDF-Datei, für die der Agent keinen Parser hat, und gibt Markdown zurück.

Häufige Fragen

ClawHub ist die Skill- und Plugin-Registry für OpenClaw-Agents. Ein Skill ist eine Markdown-Anweisungsdatei, die ein Agent liest und ausführt. Eine Installation bringt dem Agent also eine Fähigkeit bei, statt eine Abhängigkeit hinzuzufügen.
Ja. Der Skill ist kostenlos und trägt keinen eigenen Schlüssel. Sie stellen einen privaten Schlüssel aus Ihrem Dashboard bereit, und die Nutzung zählt auf Ihren eigenen Tarif, genau wie über CLI, SDKs oder API.
Fast immer fehlt ENCONVERT_API_KEY oder curl. OpenClaw filtert Skills beim Laden heraus, wenn ihre Voraussetzungen fehlen, und zwar stillschweigend. Der Agent weiß also wirklich nicht, dass es den Skill gibt.
Nein. Zwei Abrufe tragen bewusst keinen Schlüssel: das Herunterladen einer Quelldatei vor einer Konvertierung und das Abholen einer signierten Ausgabe-URL. Beide sind fremd oder bereits authentifiziert, ein Schlüssel würde also ohne Nutzen preisgegeben.
Ein Wert von 0.0 bis 1.0, der beschreibt, wie gut eine Seite tatsächlich gerendert wurde. Eine blockierte, leere oder bot-gesperrte Seite fällt niedrig aus. Der Skill weist den Agent an, einen niedrigen Wert als fehlgeschlagenen Abruf zu behandeln, nicht als Inhalt. Das ist der Unterschied zwischen einer falschen Antwort und einem neuen Versuch.
Der MCP-Server stellt dieselben Operationen als echte registrierte Tools für jeden Client bereit, der das Model Context Protocol spricht. Der ClawHub-Skill richtet sich speziell an OpenClaw-Agents und arbeitet über curl. Nehmen Sie, was Ihr Agent unterstützt.

Geben Sie Ihrem Agent einen ehrlichen Blick

Skill installieren, eine Umgebungsvariable setzen, und das Nächste, was Sie Ihren Agent lesen lassen, kommt mit einem Wert zurück.

Dokumentation lesenClawHub