Création de compétences

Création de compétences

Les compétences enseignent à l’agent comment et quand utiliser les outils. Chaque compétence est un répertoire contenant un fichier SKILL.md avec des en-têtes YAML et des instructions markdown.

Pour savoir comment les compétences sont chargées et priorisées, consultez Compétences.

Créez votre première compétence

1. Créer le répertoire de la compétence

   Les compétences résident dans votre espace de travail. Créez un nouveau dossier :

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

2. Écrire SKILL.md

   Créez SKILL.md à l’intérieur de ce répertoire. L’en-tête définit les métadonnées, et le corps markdown contient les instructions pour 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!".

3. Ajouter des outils (optionnel)

   Vous pouvez définir des schémas d’outils personnalisés dans l’en-tête ou instruire l’agent d’utiliser les outils système existants (comme exec ou browser). Les compétences peuvent également être livrées dans des plugins aux côtés des outils qu’elles documentent.

4. Charger la compétence

   Démarrez une nouvelle session pour que OpenClaw prenne en charge la compétence :

   # From chat
   /new
   
   # Or restart the gateway
   openclaw gateway restart

   Vérifiez que la compétence a été chargée :

   openclaw skills list

5. Tester

   Envoyez un message qui devrait déclencher la compétence :

   openclaw agent --message "give me a greeting"

   Ou discutez simplement avec l’agent et demandez une salutation.

Référence des métadonnées des compétences

L’en-tête YAML prend en charge ces champs :

Champ	Obligatoire	Description
name	Oui	Identifiant unique (snake_case)
description	Oui	Description en une ligne montrée à l’agent
metadata.openclaw.os	Non	Filtre OS (["darwin"], ["linux"], etc.)
metadata.openclaw.requires.bins	Non	Binaires requis sur le PATH
metadata.openclaw.requires.config	Non	Clés de configuration requises

Meilleures pratiques

• Soyez concis — indiquez au modèle quoi faire, pas comment être une IA
• Sécurité avant tout — si votre skill utilise exec, assurez-vous que les invites ne permettent pas l’injection de commandes arbitraires à partir d’une entrée non fiable
• Testez localement — utilisez openclaw agent --message "..." pour tester avant de partager
• Utilisez ClawHub — parcourez et contribuez aux skills sur ClawHub

Emplacement des skills

Emplacement	Priorité	Portée
\<workspace\>/skills/	La plus élevée	Par agent
~/.openclaw/skills/	Moyenne	Partagé (tous les agents)
Intégré (livré avec OpenClaw)	La plus basse	Global
skills.load.extraDirs	La plus basse	Dossiers partagés personnalisés

Connexes

• Référence des Skills — chargement, priorité et règles de filtrage
• Configuration des Skills — schéma de configuration skills.*
• ClawHub — registre public de skills
• Création de plugins — les plugins peuvent fournir des skills