Passer au contenu principal

​
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ées et priorisées, voir Skills.

​
Créez votre première Skill

1

Créer le répertoire de la Skill

Les Skills vivent dans votre workspace. Créez un nouveau dossier :
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

É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 pour l’agent.
---
name: hello_world
description: Une Skill simple qui dit bonjour.
---

# Hello World Skill

Quand l'utilisateur demande une salutation, utilisez l'outil `echo` pour dire
"Hello from your custom skill!".
3

Ajouter des outils (facultatif)

Vous pouvez définir des schémas d’outils personnalisés dans le frontmatter ou demander à l’agent d’utiliser des outils système existants (comme exec ou browser). Les Skills peuvent aussi être fournies dans des plugins à côté des outils qu’elles documentent.
4

Charger la Skill

Démarrez une nouvelle session pour qu’OpenClaw prenne en compte la Skill :
# Depuis le chat
/new

# Ou redémarrer la gateway
openclaw gateway restart
Vérifiez que la Skill a été chargée :
openclaw skills list
5

La tester

Envoyez un message qui doit déclencher la Skill :
openclaw agent --message "give me a greeting"
Ou discutez simplement avec l’agent et demandez une salutation.

​
Référence des métadonnées de Skill

Le frontmatter YAML prend en charge ces champs :
FieldRequiredDescription
nameOuiIdentifiant unique (snake_case)
descriptionOuiDescription sur une ligne affichée à l’agent
metadata.openclaw.osNonFiltre d’OS (["darwin"], ["linux"], etc.)
metadata.openclaw.requires.binsNonBinaires requis dans le PATH
metadata.openclaw.requires.configNonClés de configuration requises

​
Bonnes pratiques

  • Soyez concis — indiquez au modèle quoi faire, pas comment être une IA
  • La sécurité avant tout — si votre Skill utilise exec, assurez-vous que les prompts n’autorisent pas l’injection de commandes arbitraires à partir d’entrées non fiables
  • Testez localement — utilisez openclaw agent --message "..." pour tester avant de partager
  • Utilisez ClawHub — parcourez et contribuez des Skills sur ClawHub

​
Où vivent les Skills

LocationPrecedenceScope
\<workspace\>/skills/La plus hautePar agent
\<workspace\>/.agents/skills/HautePar agent du workspace
~/.agents/skills/MoyenneProfil d’agent partagé
~/.openclaw/skills/MoyennePartagé (tous les agents)
Bundled (shipped with OpenClaw)BasseGlobal
skills.load.extraDirsLa plus basseDossiers partagés personnalisés

​
Lié