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

Skills

Skills erstellen

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

Informationen dazu, wie Skills geladen und priorisiert werden, finden Sie unter Skills.

Ihren ersten Skill erstellen

  • Create the skill directory

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

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

  • Write SKILL.md

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

    ---
name: hello-world
description: 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:

    # From chat
/new

# Or restart the gateway
openclaw gateway restart

    Prüfen Sie, ob der Skill geladen wurde:

    openclaw skills list

  • Test it

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

    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 OS-Filter (["darwin"], ["linux"] usw.)
    metadata.openclaw.requires.bins Nein Erforderliche Binärdateien in PATH
    metadata.openclaw.requires.config Nein Erforderliche Konfigurationsschlüssel

    Bewährte Methoden

    • 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 Command Injection aus nicht vertrauenswürdigen Eingaben erlauben
    • Lokal testen — verwenden Sie openclaw agent --message "...", um vor dem Teilen zu testen
    • ClawHub verwenden — durchsuchen Sie Skills und tragen Sie welche bei auf ClawHub

    Speicherorte von Skills

    Speicherort Vorrang Geltungsbereich
    \<workspace\>/skills/ Höchster Pro Agent
    \<workspace\>/.agents/skills/ Hoch Pro Workspace-Agent
    ~/.agents/skills/ Mittel Gemeinsames Agentenprofil
    ~/.openclaw/skills/ Mittel Gemeinsam (alle Agenten)
    Gebündelt (mit OpenClaw ausgeliefert) Niedrig Global
    skills.load.extraDirs Niedrigster Benutzerdefinierte gemeinsame Ordner

    Verwandte Themen