​

Skills (OpenClaw)

​

Emplacements et priorité

1. Répertoires de Skills supplémentaires : configurés avec skills.load.extraDirs
2. Skills intégrés : fournis avec l’installation (package npm ou OpenClaw.app)
3. Skills gérés/locaux : ~/.openclaw/skills
4. Skills d’agent personnels : ~/.agents/skills
5. Skills d’agent de projet : <workspace>/.agents/skills
6. Skills de workspace : <workspace>/skills

​

Skills par agent vs Skills partagés

• Les Skills par agent vivent dans <workspace>/skills pour cet agent uniquement.
• Les Skills d’agent de projet vivent dans <workspace>/.agents/skills et s’appliquent à ce workspace avant le dossier skills/ normal du workspace.
• Les Skills d’agent personnels vivent dans ~/.agents/skills et s’appliquent à tous les workspaces de cette machine.
• Les Skills partagés vivent dans ~/.openclaw/skills (gérés/locaux) et sont visibles par tous les agents de la même machine.
• Des dossiers partagés peuvent aussi être ajoutés via skills.load.extraDirs (priorité la plus basse) si vous voulez un pack commun de Skills utilisé par plusieurs agents.

​

Listes d’autorisation de Skills par agent

• L’emplacement/la priorité décide quelle copie d’un Skill portant le même nom l’emporte.
• Les listes d’autorisation d’agent décident quels Skills visibles un agent peut réellement utiliser.

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // hérite de github, weather
      { id: "docs", skills: ["docs-search"] }, // remplace les valeurs par défaut
      { id: "locked-down", skills: [] }, // aucun Skill
    ],
  },
}

• Omettez agents.defaults.skills pour ne pas restreindre les Skills par défaut.
• Omettez agents.list[].skills pour hériter de agents.defaults.skills.
• Définissez agents.list[].skills: [] pour n’avoir aucun Skill.
• Une liste agents.list[].skills non vide est l’ensemble final pour cet agent ; elle ne fusionne pas avec les valeurs par défaut.

​

Plugins + Skills

​

ClawHub (installation + synchronisation)

• Installer un Skill dans votre workspace :
  • openclaw skills install <skill-slug>
• Mettre à jour tous les Skills installés :
  • openclaw skills update --all
• Synchroniser (scanner + publier les mises à jour) :
  • clawhub sync --all

​

Notes de sécurité

• Considérez les Skills tiers comme du code non fiable. Lisez-les avant de les activer.
• Préférez les exécutions en bac à sable pour les entrées non fiables et les outils risqués. Voir Sandboxing.
• La découverte de Skills dans le workspace et dans les répertoires supplémentaires n’accepte que les racines de Skills et les fichiers SKILL.md dont le realpath résolu reste dans la racine configurée.
• Les installations de dépendances de Skills pilotées par la Gateway (skills.install, onboarding et l’interface de paramètres Skills) exécutent le scanner intégré de code dangereux avant d’exécuter les métadonnées d’installation. Les résultats critical bloquent par défaut sauf si l’appelant définit explicitement le remplacement dangereux ; les résultats suspects ne produisent toujours qu’un avertissement.
• openclaw skills install <slug> est différent : il télécharge un dossier de Skill ClawHub dans le workspace et n’utilise pas le chemin de métadonnées d’installation ci-dessus.
• skills.entries.*.env et skills.entries.*.apiKey injectent des secrets dans le processus hôte pour ce tour d’agent (pas dans le sandbox). Gardez les secrets hors des prompts et des logs.
• Pour un modèle de menace plus large et des checklists, voir Sécurité.

​

Format (AgentSkills + compatible Pi)

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---

• Nous suivons la spécification AgentSkills pour la structure/l’intention.
• Le parseur utilisé par l’agent embarqué prend en charge uniquement les clés de frontmatter sur une seule ligne.
• metadata doit être un objet JSON sur une seule ligne.
• Utilisez {baseDir} dans les instructions pour référencer le chemin du dossier du Skill.
• Clés de frontmatter facultatives :
  • homepage — URL affichée comme « Website » dans l’interface macOS Skills (également prise en charge via metadata.openclaw.homepage).
  • user-invocable — true|false (par défaut : true). Si true, le Skill est exposé comme commande slash utilisateur.
  • disable-model-invocation — true|false (par défaut : false). Si true, le Skill est exclu du prompt du modèle (reste disponible via invocation utilisateur).
  • command-dispatch — tool (facultatif). Si défini sur tool, la commande slash contourne le modèle et est envoyée directement à un outil.
  • command-tool — nom de l’outil à invoquer lorsque command-dispatch: tool est défini.
  • command-arg-mode — raw (par défaut). Pour l’envoi à un outil, transmet la chaîne brute des arguments à l’outil (sans parsing côté core). L’outil est invoqué avec les paramètres : { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }.

​

Filtrage (filtres au chargement)

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

• always: true — inclut toujours le Skill (ignore les autres filtres).
• emoji — emoji facultatif utilisé par l’interface macOS Skills.
• homepage — URL facultative affichée comme « Website » dans l’interface macOS Skills.
• os — liste facultative de plateformes (darwin, linux, win32). Si définie, le Skill n’est éligible que sur ces OS.
• requires.bins — liste ; chacun doit exister dans le PATH.
• requires.anyBins — liste ; au moins un doit exister dans le PATH.
• requires.env — liste ; la variable d’environnement doit exister ou être fournie dans la configuration.
• requires.config — liste de chemins openclaw.json qui doivent être truthy.
• primaryEnv — nom de variable d’environnement associé à skills.entries.<name>.apiKey.
• install — tableau facultatif de spécifications d’installation utilisé par l’interface macOS Skills (brew/node/go/uv/download).

• requires.bins est vérifié sur l’hôte au moment du chargement du Skill.
• Si un agent est en bac à sable, le binaire doit aussi exister dans le conteneur. Installez-le via agents.defaults.sandbox.docker.setupCommand (ou une image personnalisée). setupCommand s’exécute une fois après la création du conteneur. Les installations de packages nécessitent aussi un accès réseau sortant, un système de fichiers racine inscriptible et un utilisateur root dans le sandbox. Exemple : le Skill summarize (skills/summarize/SKILL.md) a besoin de la CLI summarize dans le conteneur sandbox pour y fonctionner.

---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Install Gemini CLI (brew)",
            },
          ],
      },
  }
---

• Si plusieurs installateurs sont listés, la Gateway choisit une seule option préférée (brew si disponible, sinon node).
• Si tous les installateurs sont de type download, OpenClaw liste chaque entrée pour que vous puissiez voir les artefacts disponibles.
• Les spécifications d’installation peuvent inclure os: ["darwin"|"linux"|"win32"] pour filtrer les options par plateforme.
• Les installations Node respectent skills.install.nodeManager dans openclaw.json (par défaut : npm ; options : npm/pnpm/yarn/bun). Cela n’affecte que les installations de Skills ; le runtime Gateway doit toujours être Node (Bun n’est pas recommandé pour WhatsApp/Telegram).
• La sélection de l’installateur côté Gateway est guidée par les préférences, pas limitée à node : lorsque les spécifications d’installation mélangent plusieurs types, OpenClaw préfère Homebrew lorsque skills.install.preferBrew est activé et que brew existe, puis uv, puis le gestionnaire node configuré, puis d’autres solutions de repli comme go ou download.
• Si toutes les spécifications d’installation sont de type download, OpenClaw affiche toutes les options de téléchargement au lieu de les réduire à un seul installateur préféré.
• Installations Go : si go est absent et que brew est disponible, la gateway installe d’abord Go via Homebrew et définit GOBIN sur le répertoire bin de Homebrew lorsque c’est possible.
• Installations par téléchargement : url (obligatoire), archive (tar.gz | tar.bz2 | zip), extract (par défaut : auto lorsqu’une archive est détectée), stripComponents, targetDir (par défaut : ~/.openclaw/tools/<skillKey>).

​

Remplacements de configuration (~/.openclaw/openclaw.json)

{
  skills: {
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // ou chaîne en clair
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• enabled: false désactive le Skill même s’il est intégré/installé.
• env : injecté uniquement si la variable n’est pas déjà définie dans le processus.
• apiKey : raccourci pratique pour les Skills qui déclarent metadata.openclaw.primaryEnv. Prend en charge une chaîne en clair ou un objet SecretRef ({ source, provider, id }).
• config : conteneur facultatif pour les champs personnalisés par Skill ; les clés personnalisées doivent se trouver ici.
• allowBundled : liste d’autorisation facultative pour les Skills intégrés uniquement. Si elle est définie, seuls les Skills intégrés présents dans la liste sont éligibles (les Skills gérés/de workspace ne sont pas affectés).

​

Injection d’environnement (par exécution d’agent)

1. Lit les métadonnées des Skills.
2. Applique tout skills.entries.<key>.env ou skills.entries.<key>.apiKey à process.env.
3. Construit le prompt système avec les Skills éligibles.
4. Restaure l’environnement d’origine à la fin de l’exécution.

​

Snapshot de session (performances)

​

Nœuds macOS distants (gateway Linux)

​

Watcher de Skills (rafraîchissement automatique)

{
  skills: {
    load: {
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

​

Impact sur les tokens (liste des Skills)

• Surcharge de base (uniquement s’il y a au moins 1 Skill) : 195 caractères.
• Par Skill : 97 caractères + la longueur des valeurs XML-escaped de <name>, <description> et <location>.

total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))

• L’échappement XML développe & < > " ' en entités (&, <, etc.), ce qui augmente la longueur.
• Le nombre de tokens varie selon le tokenizer du modèle. Une estimation approximative de style OpenAI est d’environ 4 caractères/token, donc 97 caractères ≈ 24 tokens par Skill, plus la longueur réelle de vos champs.

​

Cycle de vie des Skills gérés

​

Référence de configuration

​

Vous cherchez plus de Skills ?

​

Liens associés

• Créer des Skills — créer des Skills personnalisés
• Configuration des Skills — référence de configuration des Skills
• Commandes slash — toutes les commandes slash disponibles
• Plugins — vue d’ensemble du système de plugins