Configuration des compétences

La plupart des configurations des compétences se trouvent sous skills dans ~/.openclaw/openclaw.json. La visibilité spécifique à l’agent se trouve sous agents.defaults.skills et agents.list[].skills.

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm",
      allowUploadedArchives: false,
    },
    workshop: {
      autonomous: { enabled: false },
      approvalPolicy: "pending",
      maxPending: 50,
      maxSkillBytes: 40000,
    },
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

Chargement (`skills.load`)

Répertoires de compétences supplémentaires à scanner, avec la priorité la plus faible (après les compétences groupées et les plugins). Les chemins sont développés avec le support de `~`. Répertoires cibles réels approuvés vers lesquels les dossiers de compétences liés par lien symbolique peuvent être résolus, même lorsque le lien symbolique se trouve en dehors de la racine configurée. Utilisez ceci pour des dispositions intentionnelles de dépôts frères telles que `/skills/manager -> ~/Projects/manager/skills`. Gardez cette liste restreinte — ne pointez pas vers des racines larges comme `~` ou `~/Projects`. Surveiller les dossiers de compétences et actualiser l'instantané des compétences lorsque les fichiers `SKILL.md` changent. Couvre les fichiers imbriqués sous les racines de compétences groupées. Fenêtre d'anti-rebond pour les événements de surveillance des compétences en millisecondes.

Installation (`skills.install`)

Préférer les programmes d'installation Homebrew lorsque `brew` est disponible. Préférence du gestionnaire de packages Node pour l'installation des compétences. Cela n'affecte que l'installation des compétences — le runtime Gateway doit toujours utiliser Node (Bun n'est pas recommandé pour WhatsApp/Telegram). Utilisez `openclaw setup --node-manager` pour npm, pnpm, ou bun ; définissez `"yarn"` manuellement pour les installations de compétences basées sur Yarn. Autoriser les clients Gateway de confiance `operator.admin` à installer des archives zip privées mises en scène via `skills.upload.*`. Les installations normales via ClawHub n'ont pas besoin de ce paramètre.

Liste d’autorisation des compétences groupées

Liste d'autorisation optionnelle pour les compétences **groupées** uniquement. Lorsqu'elle est définie, seules les compétences groupées de la liste sont éligibles. Les compétences gérées, au niveau de l'agent et de l'espace de travail ne sont pas affectées.

Entrées par compétence (`skills.entries`)

Les clés sous entries correspondent à la name de la compétence par défaut. Si une compétence définit metadata.openclaw.skillKey, utilisez plutôt cette clé. Mettez les noms avec des traits d’union entre guillemets (JSON5 autorise les clés entre guillemets).

`false` désactive la compétence même lorsqu'elle est groupée ou installée. La compétence groupée `coding-agent` est opt-in — définissez-la sur `true` et assurez-vous que l'un de `claude`, `codex`, `opencode`, ou un autre CLI pris en charge est installé et authentifié. Champ de commodité pour les compétences qui déclarent `metadata.openclaw.primaryEnv`. Prend en charge une chaîne en texte brut ou un SecretRef : `{ source: "env", provider: "default", id: "VAR_NAME" }`. Variables d'environnement injectées pour l'exécution de l'agent. Injectées uniquement lorsque la variable n'est pas déjà définie dans le processus. Sac optionnel pour les champs de configuration personnalisés par compétence.

Listes d’autorisation de l’agent (`agents`)

Utilisez la configuration de l’agent lorsque vous souhaitez les mêmes racines de compétence machine/espace de travail mais un ensemble de compétences visible différent pour chaque agent.

{
  agents: {
    defaults: {
      skills: ["github", "weather"], // shared baseline
    },
    list: [
      { id: "writer" }, // inherits github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults entirely
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}

Liste d'autorisation de base commune héritée par les agents qui omettent `agents.list[].skills`. Omettez entièrement pour laisser les compétences sans restriction par défaut. Ensemble final de compétences explicite pour cet agent. Les listes explicites **remplacent** les valeurs par défaut héritées — elles ne fusionnent pas. Définissez sur `[]` pour n'exposer aucune compétence pour cet agent.

Atelier (`skills.workshop`)

Lorsque `true`, les agents peuvent créer des propositions en attente à partir de signaux de conversation durables après des tours réussis. La création de compétences par l'utilisateur passe toujours par l'atelier de compétences indépendamment de ce paramètre. `pending` nécessite l'approbation de l'opérateur avant l'application, le rejet ou la mise en quarantaine initiée par l'agent. `auto` permet ces actions sans approbation. Nombre maximum de propositions en attente et mises en quarantaine conservées par espace de travail. Taille maximale du corps de la proposition en octets. Les descriptions des propositions sont limitées strictement à 160 octets car elles apparaissent dans la sortie de découverte et de listage.

Racines de compétences symboliques (symlinked)

Par défaut, les racines de skills d’espace de travail, d’agent de projet, de répertoire supplémentaire et groupées sont des limites de confinement. Un dossier de skill lié symboliquement sous <workspace>/skills qui résout en dehors de la racine est ignoré avec un message de journal.

Pour permettre une disposition intentionnelle de liens symboliques, déclarez la cible de confiance :

{
  skills: {
    load: {
      extraDirs: ["~/Projects/manager/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
    },
  },
}

Avec cette configuration, <workspace>/skills/manager -> ~/Projects/manager/skills est accepté après la résolution realpath. extraDirs analyse directement le dépôt frère ; allowSymlinkTargets préserve le chemin du lien symbolique pour les dispositions existantes.

Les répertoires gérés ~/.openclaw/skills et personnels ~/.agents/skills acceptent déjà les liens symboliques de répertoires de skills (le confinement SKILL.md par skill s’applique toujours).

Skills sandboxed et env vars

Passez des secrets dans un sandbox Docker avec :

{
  agents: {
    defaults: {
      sandbox: {
        docker: {
          env: { GEMINI_API_KEY: "your-key-here" },
        },
      },
    },
  },
}

Rappel de l’ordre de chargement

workspace/skills      (highest)
workspace/.agents/skills
~/.agents/skills
~/.openclaw/skills
bundled skills
skills.load.extraDirs (lowest)

Les modifications apportées aux skills et à la configuration prennent effet lors de la prochaine nouvelle session lorsque l’observateur est activé, ou lors du prochain tour d’agent lorsque l’observateur détecte un changement.

Connexes

Référence des Skills

Ce que sont les skills, l’ordre de chargement, le filtrage et le format SKILL.md.

Création de skills

Création de skills d’espace de travail personnalisés.

Atelier de compétences

File d’attente des propositions pour les compétences rédigées par l’agent.

Commandes slash

Catalogue natif de commandes slash et directives de chat.