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é