Compétences Clawdbot

Étendez l'assistant IA Clawdbot avec des compétences. Apprenez à créer, installer et gérer des compétences pour votre assistant IA personnel.

Aperçu des compétences Clawdbot

Clawdbot utilise des dossiers de compétences compatibles AgentSkills pour apprendre à l'agent comment utiliser les outils. Chaque compétence est un répertoire contenant un SKILL.md avec un frontmatter YAML et des instructions.

Clawdbot charge les compétences intégrées plus les remplacements locaux optionnels, et les filtre au moment du chargement en fonction de l'environnement, de la configuration et de la présence de binaires.

Emplacements des compétences et priorité

Les compétences sont chargées depuis trois endroits :

EmplacementDescription
Compétences intégréesLivrées avec l'installation (paquet npm ou Clawdbot.app)
Compétences gérées/locales~/.clawdbot/skills
Compétences de l'espace de travail<workspace>/skills

Priorité (de la plus haute à la plus basse) :

  1. <workspace>/skills
  2. ~/.clawdbot/skills
  3. Compétences intégrées

Vous pouvez configurer des dossiers de compétences supplémentaires via skills.load.extraDirs dans ~/.clawdbot/clawdbot.json.

Compétences par agent vs partagées

Dans les configurations multi-agents :

  • Compétences par agent : Situées dans <workspace>/skills pour cet agent uniquement
  • Compétences partagées : Situées dans ~/.clawdbot/skills et visibles par tous les agents

ClawHub (Installer + Synchroniser)

ClawHub est le registre public de compétences pour Clawdbot. Parcourez sur https://clawhub.com.

Flux courants :

# Installer une compétence dans votre espace de travail
clawhub install <skill-slug>

# Mettre à jour toutes les compétences installées
clawhub update --all

# Synchroniser (scanner + publier les mises à jour)
clawhub sync --all

Par défaut, clawhub installe dans ./skills sous votre répertoire de travail actuel.

Format de compétence

SKILL.md doit inclure au moins :

---
name: my-skill
description: What this skill does
---

Instructions for the agent...

Clés optionnelles du frontmatter

CléDescription
homepageURL affichée comme "Site web" dans l'interface des compétences
user-invocabletrue|false (par défaut : true) - Exposer comme commande slash pour l'utilisateur
disable-model-invocationtrue|false (par défaut : false) - Exclure du prompt du modèle
command-dispatchtool - Contourner le modèle et dispatcher directement vers un outil
command-toolNom de l'outil à invoquer quand command-dispatch: tool

Gating (filtres au chargement)

Filtrez les compétences au moment du chargement avec des métadonnées :

---
name: my-skill
description: My skill description
metadata: {"openclaw": {"requires": {"bins": ["uv"], "env": ["API_KEY"], "config": ["browser.enabled"]}}}
---

Champs de gating

ChampDescription
always: trueToujours inclure la compétence
requires.binsBinaires requis
requires.envVariables d'environnement requises
requires.configClés de configuration requises
primaryEnvVariable d'environnement principale pour la compétence

Remplacements de configuration

Remplacez les paramètres de compétence dans ~/.clawdbot/clawdbot.json :

{
  "skills": {
    "entries": {
      "my-skill": {
        "enabled": true,
        "env": {
          "API_KEY": "your-key"
        }
      }
    }
  }
}

Notes de sécurité

  • Traitez les compétences tierces comme du code non fiable
  • Lisez les compétences avant de les activer
  • Préférez les exécutions en sandbox pour les entrées non fiables
  • Gardez les secrets hors des prompts et des logs

Plugins + Compétences

Les plugins peuvent fournir leurs propres compétences en listant les répertoires de compétences dans clawdbot.plugin.json. Les compétences des plugins sont chargées lorsque le plugin est activé.

Observateur de compétences (actualisation automatique)

Clawdbot surveille les répertoires de compétences pour les changements et s'actualise automatiquement lorsque des compétences sont ajoutées, modifiées ou supprimées.

Prochaines étapes