Skills
Créer des Skills
Les Skills apprennent à l’agent comment et quand utiliser les outils. Chaque skill est un répertoire
contenant un fichier SKILL.md avec un frontmatter YAML et des instructions en markdown.
Pour savoir comment les skills sont chargés et priorisés, consultez Skills.
Créer votre premier skill
Créer le répertoire du skill
Les Skills résident dans votre espace de travail. Créez un nouveau dossier :
mkdir -p ~/.openclaw/workspace/skills/hello-world
Écrire SKILL.md
Créez SKILL.md dans ce répertoire. Le frontmatter définit les métadonnées,
et le corps markdown contient les instructions destinées à l’agent.
---
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!".
Utilisez des minuscules avec des traits d’union, des chiffres et des lettres minuscules pour le
name du skill. Gardez le nom du dossier et le name du frontmatter alignés.
Ajouter des outils (facultatif)
Vous pouvez définir des schémas d’outils personnalisés dans le frontmatter ou indiquer à l’agent
d’utiliser les outils système existants (comme exec ou browser). Les Skills peuvent également
être fournis dans des plugins aux côtés des outils qu’ils documentent.
Charger le skill
Démarrez une nouvelle session afin qu’OpenClaw détecte le skill :
# From chat
/new
# Or restart the gateway
openclaw gateway restart
Vérifiez que le skill a été chargé :
openclaw skills list
Le tester
Envoyez un message qui devrait déclencher le skill :
openclaw agent --message "give me a greeting"
Ou discutez simplement avec l’agent et demandez-lui une salutation.
Référence des métadonnées de skill
Le frontmatter YAML prend en charge ces champs :
| Champ | Obligatoire | Description |
|---|---|---|
name |
Oui | Identifiant unique utilisant des lettres minuscules, des chiffres et des traits d’union |
description |
Oui | Description sur une ligne affichée à l’agent |
metadata.openclaw.os |
Non | Filtre d’OS (["darwin"], ["linux"], etc.) |
metadata.openclaw.requires.bins |
Non | Binaires requis dans PATH |
metadata.openclaw.requires.config |
Non | Clés de configuration requises |
Bonnes pratiques
- Soyez concis — indiquez au modèle quoi faire, pas comment être une IA
- La sécurité d’abord — si votre skill utilise
exec, assurez-vous que les prompts ne permettent pas l’injection de commandes arbitraires depuis une entrée non fiable - Testez localement — utilisez
openclaw agent --message "..."pour tester avant de partager - Utilisez ClawHub — parcourez les skills et contribuez-en sur ClawHub
Où résident les skills
| Emplacement | Priorité | Portée |
|---|---|---|
\<workspace\>/skills/ |
La plus élevée | Par agent |
\<workspace\>/.agents/skills/ |
Élevée | Agent par espace de travail |
~/.agents/skills/ |
Moyenne | Profil d’agent partagé |
~/.openclaw/skills/ |
Moyenne | Partagé (tous les agents) |
| Fourni avec OpenClaw | Faible | Globale |
skills.load.extraDirs |
La plus faible | Dossiers partagés personnalisés |
Associé
- Référence des Skills — chargement, priorité et règles de contrôle
- Configuration des Skills — schéma de configuration
skills.* - ClawHub — registre public de skills
- Créer des Plugins — les plugins peuvent fournir des skills