Zum Hauptinhalt springen

Skills erstellen

Skills bringen dem Agenten bei, wie und wann Tools verwendet werden sollen. Jeder Skill ist ein Verzeichnis, das eine Datei SKILL.md mit YAML-Frontmatter und Markdown-Anweisungen enthält. Informationen dazu, wie Skills geladen und priorisiert werden, finden Sie unter Skills.

Erstellen Sie Ihren ersten Skill

1

Skill-Verzeichnis erstellen

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

SKILL.md schreiben

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

Tools hinzufügen (optional)

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

Den Skill laden

Starten Sie eine neue Sitzung, damit OpenClaw den Skill übernimmt:
# Aus dem Chat
/new

# Oder das Gateway neu starten
openclaw gateway restart
Prüfen Sie, ob der Skill geladen wurde:
openclaw skills list
5

Ihn testen

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
nameJaEindeutige Kennung (snake_case)
descriptionJaEinzeilige Beschreibung, die dem Agenten angezeigt wird
metadata.openclaw.osNeinOS-Filter (["darwin"], ["linux"] usw.)
metadata.openclaw.requires.binsNeinErforderliche Binärdateien im PATH
metadata.openclaw.requires.configNeinErforderliche Konfigurationsschlüssel

Best Practices

  • Seien Sie prägnant — 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 dazu bei unter ClawHub

Wo Skills gespeichert werden

SpeicherortPrioritätGeltungsbereich
\<workspace\>/skills/HöchstePro Agent
\<workspace\>/.agents/skills/HochPro Workspace-Agent
~/.agents/skills/MittelGeteiltes Agent-Profil
~/.openclaw/skills/MittelGeteilt (alle Agenten)
Gebündelt (mit OpenClaw ausgeliefert)NiedrigGlobal
skills.load.extraDirsNiedrigsteBenutzerdefinierte geteilte Ordner

Verwandt