Comment fonctionnent les compétences OpenClaw

Une compétence est un dossier avec un fichier SKILL.md : un en-tête YAML avec un nom et une description, puis un corps en Markdown qui apprend à l’agent comment et quand utiliser un outil. OpenClaw suit la spécification AgentSkills, charge les compétences fournies plus les vôtres, et les filtre au chargement selon l’environnement, la configuration et les binaires présents. C’est tout le mécanisme ; le reste, c’est d’où elles viennent et laquelle l’emporte.

D’où viennent les compétences, dans l’ordre

• Les compétences de l’espace de travail l’emportent : le dossier des compétences dans l’espace de travail de l’agent, puis le dossier agents du projet, puis votre dossier agents personnel.
• Les compétences locales gérées dans le répertoire d’état, partagées par tous les agents qui l’utilisent ; puis les compétences de l’Atelier qu’un agent a rédigées lui-même.
• Les compétences fournies avec l’installation, et en dernier, les répertoires supplémentaires et les compétences apportées par les extensions.
• Le même nom à deux endroits : la source la plus haute l’emporte. Les dossiers peuvent être regroupés jusqu’à six niveaux, et le nom vient de l’en-tête, pas du chemin.

Installer depuis ClawHub place une compétence dans l’espace de travail, ou dans le répertoire partagé avec l’option globale ; les mises à jour ne suivent que les installations ClawHub, si bien que les installations Git et locales se réinstallent pour se rafraîchir. Une commande de vérification demande au registre l’enveloppe de confiance de la compétence et se termine en erreur quand la vérification échoue, et la page de la compétence montre la dernière analyse avant l’installation.

Le filtrage : pourquoi une compétence n’est pas là

Une compétence peut déclarer ce dont elle a besoin : des binaires dans le chemin, des variables d’environnement, des chemins de configuration qui doivent être vrais, un système d’exploitation. Qu’il en manque un seul et la compétence est écartée au chargement, en silence. Une compétence sans bloc de métadonnées est toujours éligible sauf désactivation explicite ; un drapeau always contourne les vérifications de prérequis mais jamais le filtre de système d’exploitation.

• user-invocable : exposée comme commande slash.
• disable-model-invocation : tenue hors de l’invite normale de l’agent, toujours appelable par commande.
• command-dispatch tool : la commande contourne le modèle et appelle directement un outil enregistré.

Traitez les compétences tierces comme du code non fiable. Lisez-les avant de les activer.

La sécurité, honnêtement

La découverte des compétences refuse les chemins qui sortent de leur racine, l’Atelier rejette les compétences en lien symbolique, et la documentation recommande les exécutions en bac à sable pour les entrées non fiables. Rien de tout cela ne lit la compétence à votre place. Qu’est-ce que ClawHub explique les statuts d’audit du registre ; la règle pratique, c’est qu’une compétence est des instructions plus des scripts, et que les scripts s’exécutent avec tout ce que l’agent peut exécuter.

Compétences, extensions et Atelier

Les extensions sont du code et les compétences des instructions ; les extensions peuvent embarquer des compétences. L’Atelier est l’endroit où l’agent rédige des compétences à partir de son propre travail et où vous les approuvez. Lesquelles installer en premier est une autre question, et les meilleures compétences OpenClaw à installer en premier y répond avec les verdicts de sécurité.

Sur Diali

Le catalogue de Diali porte les compétences du registre pour les deux moteurs avec sa propre revue sur chacune, les installe dans le bac à sable de l’assistant depuis le tableau de bord, et y recueille les clés dont une compétence a besoin plutôt que dans un fichier de configuration. L’ordre de chargement et le filtrage sont le même OpenClaw en dessous. Le catalogue de compétences Diali est le catalogue ; OpenClaw hébergé sur Diali est l’assistant.

• Un dossier, un SKILL.md, un nom et une description.
• Le plus proche de l’espace de travail l’emporte ; les prérequis manquants filtrent en silence.
• Les compétences tierces sont du code : lisez-les, puis isolez-les.