English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Skills

Skills erstellen

Skills vermitteln dem Agenten, wie und wann er Tools verwenden soll. Jeder Skill ist ein Verzeichnis mit einer SKILL.md-Datei, die YAML-Frontmatter und Markdown-Anweisungen enthält.

Wie Skills geladen und priorisiert werden, erfahren Sie unter Skills.

Erstellen Sie Ihren ersten Skill

  • Create the skill directory

    Skills befinden sich in Ihrem Arbeitsbereich. Erstellen Sie einen neuen Ordner:

    bash
    mkdir -p ~/.openclaw/workspace/skills/hello-world

  • Write SKILL.md

    Erstellen Sie SKILL.md in diesem Verzeichnis. Das Frontmatter definiert Metadaten, und der Markdown-Text enthält Anweisungen für den Agenten.

    markdown
    ---name: hello-worlddescription: A simple skill that says hello.--- # Hello World Skill When the user asks for a greeting, use the `echo` tool to say"Hello from your custom skill!".

    Verwenden Sie Bindestrich-Schreibweise mit Kleinbuchstaben, Ziffern und Bindestrichen für den Skill- name. Halten Sie den Ordnernamen und den Frontmatter-name konsistent.

  • Add tools (optional)

    Sie können benutzerdefinierte Tool-Schemas im Frontmatter definieren oder den Agenten anweisen, vorhandene System-Tools (wie exec oder browser) zu verwenden. Skills können auch innerhalb von Plugins zusammen mit den Tools ausgeliefert werden, die sie dokumentieren.

  • Load the skill

    Starten Sie eine neue Sitzung, damit OpenClaw den Skill übernimmt:

    bash
    # From chat/new # Or restart the gatewayopenclaw gateway restart

    Prüfen Sie, ob der Skill geladen wurde:

    bash
    openclaw skills list

  • Test it

    Senden Sie eine Nachricht, die den Skill auslösen sollte:

    bash
    openclaw agent --message "give me a greeting"

    Oder chatten Sie einfach mit dem Agenten und bitten Sie um eine Begrüßung.

    • Referenz für Skill-Metadaten

    Das YAML-Frontmatter unterstützt diese Felder:

    Feld Erforderlich Beschreibung
    name Ja Eindeutiger Bezeichner mit Kleinbuchstaben, Ziffern und Bindestrichen
    description Ja Einzeilige Beschreibung, die dem Agenten angezeigt wird
    metadata.openclaw.os Nein Betriebssystemfilter (["darwin"], ["linux"] usw.)
    metadata.openclaw.requires.bins Nein Erforderliche Binärdateien auf PATH
    metadata.openclaw.requires.config Nein Erforderliche Konfigurationsschlüssel

    Best Practices

    • Fassen Sie sich kurz — weisen Sie das Modell an, was zu tun ist, nicht wie es eine KI sein soll
    • Sicherheit zuerst — wenn Ihr Skill exec verwendet, stellen Sie sicher, dass Prompts keine beliebige Befehlsinjektion aus nicht vertrauenswürdigen Eingaben zulassen
    • Lokal testen — verwenden Sie openclaw agent --message "...", um vor dem Teilen zu testen
    • ClawHub verwenden — durchsuchen Sie Skills und tragen Sie Skills unter ClawHub bei

    Wo Skills gespeichert sind

    Speicherort Vorrang Geltungsbereich
    \<workspace\>/skills/ Höchster Pro Agent
    \<workspace\>/.agents/skills/ Hoch Pro Arbeitsbereich-Agent
    ~/.agents/skills/ Mittel Geteiltes Agentenprofil
    ~/.openclaw/skills/ Mittel Geteilt (alle Agenten)
    Mitgeliefert (mit OpenClaw ausgeliefert) Niedrig Global
    skills.load.extraDirs Niedrigster Benutzerdefinierte geteilte Ordner

    Verwandt

    Was this useful?