Comment créer une compétence OpenClaw

Les compétences apprennent à l’agent comment et quand utiliser les outils. Chacune est un répertoire contenant un fichier SKILL.md avec un en-tête YAML et des instructions en markdown, chargé depuis plusieurs racines dans un ordre de priorité défini, le dossier de compétences de l’espace de travail en premier. Voici la première compétence en quatre étapes, la référence de l’en-tête, l’activation conditionnelle et le câblage des clés, la voie des compétences personnelles sur une passerelle partagée, le chemin des propositions Workshop pour les compétences qui doivent être revues, la publication, et les bonnes pratiques par lesquelles la documentation conclut.

Votre première compétence

• Créez le répertoire sous le dossier de compétences de l’espace de travail ; les sous-dossiers conviennent pour l’organisation, puisque la compétence est nommée par son en-tête, pas par le chemin du dossier.
• Écrivez SKILL.md : un nom en lettres minuscules, chiffres et tirets, aligné sur le nom du répertoire, et une description d’une ligne de moins de 160 caractères que l’agent voit et que la découverte des commandes slash affiche ; le corps est l’instruction, par exemple quel outil lancer et comment.
• Vérifiez son chargement avec la commande de liste des compétences ; le surveillant détecte les nouveaux fichiers par défaut, et une session existante a besoin d’une nouvelle session ou d’un redémarrage de la passerelle pour voir la liste rafraîchie.
• Testez-la depuis la CLI avec une exécution d’agent à un message, depuis le chat en demandant, ou explicitement avec la commande de compétence et son nom.

Les compétences apprennent à l’agent comment et quand utiliser les outils.

La référence

Deux champs requis, le nom et la description. Les clés facultatives : user-invocable, vrai par défaut, expose la compétence comme commande slash ; disable-model-invocation la garde hors du prompt système tout en la laissant exécutable par commande ; command-dispatch mis à tool route la commande directement vers un outil nommé, en contournant le modèle, avec un mode d’arguments bruts ; et une URL de page d’accueil. Un espace réservé de répertoire de base référence des fichiers dans la compétence sans coder les chemins en dur. L’activation conditionnelle vit dans les métadonnées : tous les binaires d’une liste doivent exister, ou au moins un d’une autre liste, des variables d’environnement doivent exister dans le processus ou la configuration, des chemins de configuration doivent être vrais, un filtre de système, et un indicateur always qui inclut la compétence sur un système compatible même quand les vérifications échouent. Une clé d’API se câble à l’entrée de compétence dans la configuration, prise dans l’environnement, et injectée dans le processus hôte pour ce tour d’agent seulement ; elle n’atteint pas le bac à sable.

Compétences personnelles, propositions, publication

• Pour une compétence qui doit suivre votre profil connecté plutôt qu’un espace de travail d’agent sur une passerelle partagée, la page des extensions a une section de compétences personnelles où vous créez ou importez le paquet et revoyez la révision enregistrée, sans accès au shell de l’hôte ; l’agent peut aussi en rédiger une par son outil Workshop, qui indique si le résultat est publié ou une proposition en attente.
• Pour les compétences rédigées par l’agent ou quand un opérateur doit revoir avant qu’une compétence soit active, la CLI du Workshop propose une nouvelle compétence ou une mise à jour à partir d’un fichier de proposition, ou d’un répertoire de proposition avec des fichiers de support sous assets, examples, references, scripts ou templates, et après revue vous inspectez, évaluez et appliquez.
• Publier sur ClawHub exige un identifiant d’éditeur, personnel ou celui d’une organisation où vous avez un rôle de publication, la CLI ClawHub autonome installée et connectée, et une commande de publication pointée vers le répertoire de la compétence, avec des options pour remplacer la version déduite ou le propriétaire.

Les compétences d’OpenClaw expliquées explique comment les compétences se chargent et se filtrent une fois qu’elles existent, et L’auto-apprentissage d’OpenClaw comment l’agent écrit les siennes.

Bonnes pratiques

Quatre lignes de la documentation : être concis et dire au modèle quoi faire, pas comment être une IA ; la sûreté d’abord, donc une compétence qui utilise exec ne doit pas laisser une entrée non fiable injecter des commandes arbitraires ; tester localement avec une exécution à un message avant de partager ; et parcourir le registre communautaire avant de construire de zéro. Qu’est-ce que ClawHub explique le registre, et Les meilleures compétences OpenClaw les compétences qui valent l’installation avant d’en écrire une.

Sur Diali

Sur Diali, le catalogue installe une compétence en un clic et un SKILL.md de votre cru va dans le même dossier de l’espace de travail ; les identifiants dont une compétence a besoin se règlent par compétence depuis le tableau de bord plutôt que dans le fichier de configuration. OpenClaw hébergé sur Diali est l’assistant.

• Un répertoire, un SKILL.md, un nom et une description.
• Filtrer sur les binaires, l’environnement et le système ; les clés n’atteignent jamais le bac à sable.
• Proposer par Workshop quand quelqu’un doit revoir d’abord.