OpenClaw Skills erstellen und pruefen

Was du bauen wirst

Einen Skill-Entwicklungs- und Review-Workflow, mit dem du:

1. Eigene Skills baust — neue OpenClaw Skills erstellst, die genau auf deine Beduerfnisse zugeschnitten sind
2. Community-Skills pruefst — Skills von ClawHub auf Qualitaet, Sicherheit und Zuverlaessigkeit kontrollierst
3. Komplexe Aufgaben zerlegst — mehrstufige Workflows in wiederverwendbare Skill-Ketten aufteilst
4. Iterativ verbesserst — Skills mit KI-gestuetztem Feedback testest, debuggst und verfeinerst

Nach dieser Anleitung kannst du produktionsreife Skills erstellen und jeden Skill vor der Installation zuverlaessig bewerten.

Warum eigene Skills bauen

ClawHub bietet Hunderte Community-Skills, aber manchmal brauchst du etwas Spezifisches:

• Interne Tools — die APIs, Dashboards und Workflows deines Unternehmens werden von oeffentlichen Skills nicht abgedeckt
• Individuelle Integrationen — du nutzt Nischen-Tools oder proprietaere Systeme, die eigene Konnektoren brauchen
• Workflow-Optimierung — mehrere Skills zu einem einzigen, optimierten Skill zusammenzufassen spart Zeit
• Qualitaetskontrolle — eigene Skills bedeuten: du weisst genau, was sie tun
• Wettbewerbsvorteil — einzigartige Automatisierungs-Workflows, die deine Konkurrenz nicht hat

Warum Skills vor der Installation pruefen

Nicht jeder Skill auf ClawHub ist produktionsreif. Bevor du einen Community-Skill installierst:

• Sicherheit — ein Skill koennte auf dein Dateisystem, Netzwerk oder deine Zugangsdaten in unerwarteter Weise zugreifen
• Qualitaet — manche Skills sind Prototypen oder Proof-of-Concepts, keine produktionsreifen Loesungen
• Wartung — aufgegebene Skills funktionieren moeglicherweise nicht mit neueren OpenClaw-Versionen
• Abhaengigkeiten — ein Skill koennte externe Services oder API-Keys erfordern, die du nicht hast
• Berechtigungen — verstehe genau, welche Zugriffsrechte ein Skill anfordert, bevor du sie gewaehrst

Voraussetzungen

• OpenClaw installiert und konfiguriert (Erste-Schritte-Anleitung)
• Vertrautheit mit YAML und grundlegendem Scripting
• Node.js 18+

Schritt 1: Skill-Entwicklungstools installieren

# 1. Skill Builder — fuehrt dich durch die Erstellung gut strukturierter Skills
npx clawhub@latest install skill-builder

# 2. Skill Reviewer — Qualitaets- und Strukturanalyse
npx clawhub@latest install skill-reviewer

# 3. Task Decomposer — zerlegt komplexe Aufgaben in Skill-Ketten
npx clawhub@latest install task-decomposer

Schritt 2: Deinen ersten eigenen Skill erstellen

Skill-Struktur verstehen

Ein OpenClaw Skill dreht sich um eine SKILL.md-Datei — das zentrale Anweisungsdokument, das dem KI-Agenten erklaert, wie eine Aufgabe auszufuehren ist. Der Skill Builder Skill fuehrt dich durch die Erstellung gut strukturierter Skills nach Best Practices.

Eine typische Skill-Struktur sieht so aus:

my-custom-skill/
  ├── SKILL.md             # Kernanweisungen fuer den Agenten
  ├── [topic].md           # On-Demand-Detaildateien (bei Bedarf geladen)
  ├── references/          # Ausfuehrliche Dokumentation, Beispiele
  └── scripts/             # Optionale Automatisierungsskripte

Deine SKILL.md schreiben

Die SKILL.md ist das Herzstueck deines Skills. Bitte OpenClaw (mit installiertem Skill Builder Skill), dir beim Schreiben zu helfen:

Help me create a skill that searches a custom API for products.
The API is at https://api.example.com/search and requires an API key.

Der Skill Builder fuehrt dich durch:

• Modulare Struktur — die SKILL.md fokussiert halten und separate Dateien fuer detaillierte Themen verwenden
• Progressive Disclosure — Detaildateien nur laden, wenn der Agent sie braucht
• Token-effizientes Design — den Context-Window-Verbrauch minimieren
• Klare Ein-/Ausgabe — definieren, was der Skill erwartet und zurueckgibt

Beispiel-SKILL.md

# Product Search Skill

Search the product catalog API for items matching a query.

## Configuration
- `API_URL`: Base URL of the product API
- `API_KEY`: API key for authentication (set as environment variable)

## Usage
When the user asks to search for products, use the API:

GET {API_URL}/search?q={query}
Authorization: Bearer {API_KEY}

## Response Format
Return results as a structured list with name, price, and URL for each product.

Skill testen

Installiere deinen Skill lokal und teste ihn:

clawhub install ./my-custom-skill

Dann probiere ihn in OpenClaw aus, um sicherzustellen, dass er wie erwartet funktioniert.

Schritt 3: Einen Community-Skill pruefen

Bevor du einen Skill von ClawHub installierst, pruefe ihn:

clawhub run skill-reviewer --skill "clawhub-username/skill-name"

Der Reviewer analysiert die SKILL.md und die zugehoerigen Dateien des Skills und prueft:

=== Skill Review: awesome-slack-bot ===

## Structure Assessment
✓ SKILL.md is well-organized with clear sections
✓ Description is specific and actionable
✓ Input/output expectations are documented
✓ Usage examples included
⚠ Missing on-demand detail files — all content is in one large SKILL.md

## Quality Score
✓ Frontmatter is complete (name, description, version)
✓ Instructions are token-efficient — progressive disclosure used
✓ Error handling guidance included
⚠ No rate limiting guidance — may hit API limits under heavy use

## Description Quality: 8.5/10
Recommendation: Well-structured skill, ready for use

Worauf du achten solltest

Warnzeichen

• Skill fordert Berechtigungen an, die er nicht brauchen sollte (z. B. ein Such-Skill, der Schreibzugriff auf Dateien will)
• Keine Tests oder Dokumentation
• Letzte Aktualisierung vor ueber 6 Monaten
• Hartcodierte URLs oder Zugangsdaten im Quellcode
• Obfuskierter oder minifizierter Code

Positive Zeichen

• Klare Berechtigungsdeklarationen, die zur tatsaechlichen Nutzung passen
• Umfassende Testabdeckung
• Aktive Wartung und Community-Engagement
• Transparenter Quellcode
• Gut dokumentierte Konfiguration

Schritt 4: Komplexe Aufgaben zerlegen

Der Task Decomposer Skill hilft, komplexe Anfragen in ausfuehrbare Schritte zu zerlegen. Frage OpenClaw:

Decompose this task: Monitor competitor pricing pages daily and alert me when prices change

Beispielausgabe:

=== Task Decomposition ===

Task: Monitor competitor pricing pages daily and alert when prices change

## Skill Chain

1. **browser-use** — Navigate to each competitor's pricing page
   Input: List of competitor URLs
   Output: Page content / screenshots

2. **web-scraper** — Extract pricing data from each page
   Input: Page content
   Output: Structured pricing data (JSON)

3. **file_read** — Load yesterday's pricing data for comparison
   Input: File path to stored data
   Output: Previous pricing data

4. **summarize** — Compare current vs. previous pricing and identify changes
   Input: Current data + previous data
   Output: Change report

5. **telegram** (or email) — Send alert if changes detected
   Input: Change report
   Output: Notification sent

## Required Skills
- browser-use (installed: yes)
- web-scraper (installed: yes)
- summarize (installed: yes)
- telegram (installed: no — install with: npx clawhub@latest install telegram)

## Estimated Setup Time: 20 minutes

Von der Zerlegung zum Workflow

Verwandle die Zerlegung in einen wiederverwendbaren Workflow:

# .openclaw/price-monitor.yml
name: competitor-price-monitor
schedule: "0 9 * * *"
steps:
  - skill: browser-use
    action: navigate
    urls:
      - "https://competitor1.com/pricing"
      - "https://competitor2.com/pricing"

  - skill: web-scraper
    action: extract
    format: json
    target: "pricing tables"

  - skill: summarize
    action: compare
    current: "{{step_2.output}}"
    previous: "./data/last-pricing.json"

  - skill: telegram
    action: send
    condition: "changes_detected"
    message: "{{step_3.output}}"

  - action: save
    data: "{{step_2.output}}"
    path: "./data/last-pricing.json"

Schritt 5: Deinen Skill veroeffentlichen

Wenn dein Skill fertig ist, veroeffentliche ihn auf ClawHub:

clawhub publish my-custom-skill

Stelle vor der Veroeffentlichung sicher:

• SKILL.md ist vollstaendig und gut strukturiert
• Beschreibung ist spezifisch und aussagekraeftig
• Keine hartcodierten Secrets in irgendeiner Datei
• Versionsnummer folgt semver

Fehlerbehebung

Skill funktioniert nicht wie erwartet

• Pruefe, ob die SKILL.md-Anweisungen klar und spezifisch sind
• Teste mit verschiedenen Prompts, um zu sehen, ob der Agent den Skill korrekt interpretiert
• Lies die Skill-Builder-Richtlinien fuer haeufige Anweisungsfehler durch

"Permission denied" bei der Skill-Ausfuehrung

• Pruefe, worauf der Skill zugreift — Dateien, Netzwerk, Zugangsdaten
• Stelle sicher, dass du die erforderlichen Berechtigungen bei der Installation gewaehrt hast
• Einige Berechtigungen erfordern beim ersten Lauf eine explizite Bestaetigung

Skill Reviewer zeigt falsche Warnungen

• Der Reviewer ist konservativ — er markiert alles, was problematisch sein koennte
• Pruefe die spezifischen Warnungen und entscheide, ob sie auf deinen Anwendungsfall zutreffen
• Nicht jede Warnung ist ein echtes Problem — nutze dein Urteilsvermoegen

Veroeffentlichter Skill erscheint nicht auf ClawHub

• Die Veroeffentlichung kann einige Minuten brauchen, bis sie sichtbar wird
• Pruefe, ob dein ClawHub-Account verifiziert ist
• Stelle sicher, dass der Skill-Name nicht mit einem bestehenden Skill kollidiert

Haeufige Fragen

Muss ich Python koennen, um Skills zu bauen?

Nein. Die meisten OpenClaw Skills basieren auf einer SKILL.md-Datei — einem Markdown-Dokument, das dem KI-Agenten erklaert, wie eine Aufgabe auszufuehren ist. Du kannst effektive Skills allein mit klaren schriftlichen Anweisungen und API-Dokumentation erstellen. Fuer komplexere Automatisierungen kannst du Skripte (Python, Bash usw.) neben der SKILL.md einbinden, aber das ist optional.

Kann ich private Skills bauen, die nicht auf ClawHub veroeffentlicht werden?

Ja. Skills koennen lokal installiert werden, ohne sie zu veroeffentlichen. Behalte das Skill-Verzeichnis in deinem Projekt oder einem privaten Repository und installiere es mit einem lokalen Pfad: clawhub install ./my-custom-skill. Das ist ueblich fuer unternehmensinterne Integrationen, die nicht oeffentlich sein sollen.

Wie aktualisiere ich einen veroeffentlichten Skill?

Erhoehe die Version in den Metadaten deines Skills, aktualisiere das Changelog im README und fuehre erneut clawhub publish aus. ClawHub verwaltet die Versionierung — Nutzer mit aelteren Versionen werden nicht automatisch aktualisiert, es sei denn, sie fuehren clawhub update aus.

Welche Berechtigungen sollte ich fuer meinen Skill anfordern?

Folge dem Prinzip der minimalen Berechtigung. Fordere nur Berechtigungen an, die dein Skill tatsaechlich braucht. Gaengige Berechtigungskombinationen: nur Netzwerk (fuer API-Integrationen), Netzwerk + file_read (fuer Datenverarbeitung), Netzwerk + credentials (fuer authentifizierte APIs). Vermeide file_write, es sei denn, dein Skill muss Ausgaben auf die Festplatte schreiben.

Wie gehe ich mit API-Ratenlimits in meinem Skill um?

Fuege Ratenlimit-Hinweise in deine SKILL.md ein — weise den Agenten an, bei API-Aufrufen exponentielles Backoff zu implementieren. Fuer Skills, die mit ratenlimitierten APIs interagieren, dokumentiere die Limits im README, damit Nutzer wissen, was sie erwartet, und baue Retry-Logik in enthaltene Skripte ein.

Kann ich mehrere bestehende Skills zu einem neuen Skill zusammensetzen?

Ja — das ist eines der maechtigsten Muster. Verwende YAML-Workflow-Definitionen, um Skills zu verketten, oder nutze den Task Decomposer, um die richtige Skill-Kette fuer deinen Anwendungsfall zu identifizieren. Der resultierende Workflow kann als neuer Skill gespeichert werden, der intern an andere Skills delegiert. So werden die meisten fortgeschrittenen Automatisierungen gebaut.