OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Skills

Skills erstellen

Skills zeigen 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. OpenClaw lädt Skills aus mehreren Stammverzeichnissen in einer festgelegten Prioritätsreihenfolge.

Erstellen Sie Ihren ersten Skill

  • Erstellen Sie das Skill-Verzeichnis

    Skills befinden sich im Ordner skills/ Ihres Workspace:

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

    Sie können Skills zur besseren Organisation in Unterordnern gruppieren — der Skill wird weiterhin durch das SKILL.md-Frontmatter benannt, nicht durch den Ordnerpfad:

    bash
    mkdir -p ~/.openclaw/workspace/skills/personal/hello-world# Der Skill heißt weiterhin "hello-world" und wird als /hello-world aufgerufen

  • Schreiben Sie SKILL.md

    Das Frontmatter definiert die Metadaten; der Textkörper enthält die Anweisungen für den Agenten.

    markdown
    ---name: hello-worlddescription: Ein einfacher Skill, der eine Begrüßung ausgibt.--- # Hallo Welt Wenn der Benutzer um eine Begrüßung bittet, verwenden Sie das Tool `exec`, um Folgendes auszuführen: ```bashecho "Hallo von Ihrem benutzerdefinierten Skill!"
    Code
     Benennungsregeln:- Verwenden Sie für `name` Kleinbuchstaben, Ziffern und Bindestriche.- Halten Sie den Verzeichnisnamen und den Frontmatter-Wert `name` konsistent.- `description` wird dem Agenten und bei der Ermittlung von Slash-Befehlen angezeigt —  halten Sie die Beschreibung einzeilig und kürzer als 160 Zeichen.  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSLDnGJlcnByw7xmZW4gU2llLCBvYiBkZXIgU2tpbGwgZ2VsYWRlbiB3dXJkZSI ```bashopenclaw skills list

    OpenClaw überwacht standardmäßig SKILL.md-Dateien unter den Stammverzeichnissen für Skills. Wenn die Überwachung deaktiviert ist oder Sie eine bestehende Sitzung fortsetzen, starten Sie eine neue, damit der Agent die aktualisierte Liste erhält:

    bash
    # Im Chat — aktuelle Sitzung archivieren und eine neue starten/new # Oder den Gateway neu startenopenclaw gateway restart

  • Testen Sie den Skill

    bash
    openclaw agent --message "Gib mir eine Begrüßung"

    Alternativ können Sie einen Chat öffnen und den Agenten direkt fragen. Verwenden Sie /skill hello-world, um den Skill ausdrücklich über seinen Namen aufzurufen.

    • SKILL.md-Referenz

    Erforderliche Felder

    Feld Beschreibung
    name Eindeutiger Slug aus Kleinbuchstaben, Ziffern und Bindestrichen
    description Einzeilige Beschreibung, die dem Agenten und bei der Ermittlung angezeigt wird

    Optionale Frontmatter-Schlüssel

    Feld Standardwert Beschreibung
    user-invocable true Stellt den Skill als Slash-Befehl für Benutzer bereit
    disable-model-invocation false Schließt den Skill vom System-Prompt des Agenten aus (wird weiterhin über /skill ausgeführt)
    command-dispatch — Auf tool setzen, um den Slash-Befehl unter Umgehung des Modells direkt an ein Tool weiterzuleiten
    command-tool — Name des aufzurufenden Tools, wenn command-dispatch: tool festgelegt ist
    command-arg-mode raw Leitet bei der Tool-Weiterleitung die unverarbeitete Argumentzeichenfolge an das Tool weiter
    homepage — URL, die in der macOS-Benutzeroberfläche für Skills als "Website" angezeigt wird

    Informationen zu Aktivierungsfeldern (requires.bins, requires.env usw.) finden Sie unter Skills — Aktivierungsbedingungen.

    Verwendung von {baseDir}

    Verweisen Sie auf Dateien innerhalb des Skill-Verzeichnisses, ohne Pfade fest zu codieren — der Agent löst {baseDir} relativ zum eigenen Verzeichnis des Skills auf:

    markdown
    Führen Sie das Hilfsskript unter `{baseDir}/scripts/run.sh` aus.

    Bedingte Aktivierung hinzufügen

    Beschränken Sie Ihren Skill so, dass er nur geladen wird, wenn seine Abhängigkeiten verfügbar sind:

    markdown
    ---name: gemini-searchdescription: Suche mit der Gemini CLI.metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }---
    Aktivierungsoptionen
    Schlüssel Beschreibung
    requires.bins Alle Binärdateien müssen in PATH vorhanden sein
    requires.anyBins Mindestens eine Binärdatei muss in PATH vorhanden sein
    requires.env Jede Umgebungsvariable muss im Prozess oder in der Konfiguration vorhanden sein
    requires.config Jeder Pfad in openclaw.json muss einen Wahrheitswert ergeben
    os Plattformfilter: ["darwin"], ["linux"], ["win32"]
    always Auf true setzen, um alle Aktivierungsbedingungen zu überspringen und den Skill immer einzubeziehen

    Vollständige Referenz: Skills — Aktivierungsbedingungen.

    Umgebung und API-Schlüssel

    Verknüpfen Sie einen API-Schlüssel mit einem Skill-Eintrag in openclaw.json:

    json5
    {  skills: {    entries: {      "gemini-search": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },      },    },  },}

    Der Schlüssel wird nur für diesen Agentendurchlauf in den Hostprozess eingefügt. Er gelangt nicht in die Sandbox — siehe Umgebungsvariablen in der Sandbox.

    Über Skill Workshop vorschlagen

    Verwenden Sie für vom Agenten entworfene Skills oder wenn Sie vor der Aktivierung eines Skills eine Prüfung durch den Betreiber wünschen, Vorschläge im Skill Workshop, statt SKILL.md direkt zu schreiben.

    bash
    # Einen völlig neuen Skill vorschlagenopenclaw skills workshop propose-create \  --name "hello-world" \  --description "Ein einfacher Skill, der eine Begrüßung ausgibt." \  --proposal ./PROPOSAL.md # Eine Aktualisierung für einen bestehenden Skill vorschlagenopenclaw skills workshop propose-update hello-world \  --proposal ./PROPOSAL.md \  --description "Aktualisierter Begrüßungs-Skill"

    Verwenden Sie --proposal-dir, wenn der Vorschlag unterstützende Dateien enthält:

    bash
    openclaw skills workshop propose-create \  --name "hello-world" \  --description "Ein einfacher Skill, der eine Begrüßung ausgibt." \  --proposal-dir ./hello-world-proposal/

    Das Verzeichnis muss in seinem Stammverzeichnis eine Datei namens PROPOSAL.md enthalten. Unterstützende Dateien gehören in assets/, examples/, references/, scripts/ oder templates/.

    Nach der Prüfung:

    bash
    openclaw skills workshop inspect <proposal-id>openclaw skills workshop apply <proposal-id>

    Den vollständigen Lebenszyklus eines Vorschlags finden Sie unter Skill Workshop.

    Auf ClawHub veröffentlichen

  • Stellen Sie sicher, dass Ihre SKILL.md vollständig ist

    Vergewissern Sie sich, dass name, description und alle Aktivierungsfelder unter metadata.openclaw festgelegt sind. Fügen Sie eine homepage-URL hinzu, wenn Sie über eine Projektseite verfügen.

  • Installieren Sie die eigenständige ClawHub CLI und melden Sie sich an

    bash
    npm i -g clawhubclawhub login

  • Veröffentlichen

    bash
    clawhub skill publish ./path/to/hello-world

    Fügen Sie --version <version> oder --owner <owner> hinzu, um die abgeleitete Version zu überschreiben oder unter einem bestimmten Eigentümer zu veröffentlichen. Unter ClawHub — Veröffentlichung und ClawHub CLI finden Sie den vollständigen Ablauf, die Zuordnung zu Eigentümern und weitere Wartungsbefehle (clawhub sync, clawhub skill rename, ...).

    • Bewährte Methoden

    Verwandte Themen

    Skills-Referenz

    Ladereihenfolge, Aktivierungsbedingungen, Zulassungslisten und das SKILL.md-Format.
    Skill Workshop

    Vorschlagswarteschlange für vom Agenten entworfene Skills.
    Skills-Konfiguration

    Vollständiges Konfigurationsschema für skills.*.
    ClawHub

    Durchsuchen und veröffentlichen Sie Skills im öffentlichen Register.
    Plugins entwickeln

    Plugins können Skills zusammen mit den Tools bereitstellen, die sie dokumentieren.
    Was this useful?
    On this page

    On this page