Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

1

Create the skill directory

Skills befinden sich in Ihrem Arbeitsbereich. Erstellen Sie einen neuen Ordner:
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

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.
---
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.
3

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.
4

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
5

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:
FeldErforderlichBeschreibung
nameJaEindeutiger Bezeichner mit Kleinbuchstaben, Ziffern und Bindestrichen
descriptionJaEinzeilige Beschreibung, die dem Agenten angezeigt wird
metadata.openclaw.osNeinBetriebssystemfilter (["darwin"], ["linux"] usw.)
metadata.openclaw.requires.binsNeinErforderliche Binärdateien auf PATH
metadata.openclaw.requires.configNeinErforderliche 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

SpeicherortVorrangGeltungsbereich
\<workspace\>/skills/HöchsterPro Agent
\<workspace\>/.agents/skills/HochPro Arbeitsbereich-Agent
~/.agents/skills/MittelGeteiltes Agentenprofil
~/.openclaw/skills/MittelGeteilt (alle Agenten)
Mitgeliefert (mit OpenClaw ausgeliefert)NiedrigGlobal
skills.load.extraDirsNiedrigsterBenutzerdefinierte geteilte Ordner

Verwandt