Configuration des Skills

La plupart de la configuration des Skills se trouve sous skills dans ~/.openclaw/openclaw.json. La visibilité propre à chaque 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 },      allowSymlinkTargetWrites: 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)

Installation (skills.install)

Politique d’installation de l’opérateur (security.installPolicy)

Utilisez security.installPolicy lorsque les opérateurs ont besoin d’une commande locale approuvée pour autoriser ou bloquer les installations de Skills et de Plugins selon une politique propre à l’hôte. La politique s’exécute après qu’OpenClaw a préparé les éléments sources et avant la poursuite de l’installation ou de la mise à jour. Elle s’applique aux Skills ClawHub, aux Skills téléversés, aux Skills Git/locaux, aux programmes d’installation des dépendances de Skills ainsi qu’aux sources d’installation et de mise à jour des Plugins.

{  security: {    installPolicy: {      enabled: true,      // Omit targets to cover every supported target.      targets: ["skill", "plugin"],      exec: {        source: "exec",        command: "/usr/local/bin/openclaw-install-policy",        args: ["--json"],        timeoutMs: 10000,        noOutputTimeoutMs: 10000,        maxOutputBytes: 1048576,        passEnv: ["OPENCLAW_STATE_DIR", "PATH"],        env: { POLICY_MODE: "strict" },        trustedDirs: ["/usr/local/bin"],      },    },  },}

La politique reçoit sur l’entrée standard un objet JSON contenant protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, ainsi que les champs structurés facultatifs source, origin et request. Elle doit écrire sur la sortie standard un objet JSON : { "protocolVersion": 1, "decision": "allow" } ou { "protocolVersion": 1, "decision": "block", "reason": "..." }. Un code de sortie non nul, un dépassement de délai, un JSON mal formé, des champs manquants ou des versions de protocole non prises en charge entraînent un refus par défaut.

OpenClaw n’exécute pas la politique d’installation lors du démarrage normal du Gateway. Les installations et les mises à jour sont refusées par défaut lorsque la politique est activée mais indisponible. openclaw doctor effectue une validation statique ; openclaw doctor --deep exécute une vérification d’installation synthétique sur la commande configurée.

Les mises à jour groupées appliquent la politique à chaque cible : le blocage de la mise à jour d’un Skill ou d’un Plugin fait échouer cette cible sans désactiver la politique ni ignorer les cibles suivantes du lot.

Exemple d’entrée standard :

{  "protocolVersion": 1,  "openclawVersion": "2026.6.1",  "targetType": "skill",  "targetName": "weather",  "sourcePath": "/var/folders/.../openclaw-skill-clawhub/root",  "sourcePathKind": "directory",  "source": {    "kind": "clawhub",    "authority": "openclaw",    "mutable": false,    "network": true  },  "origin": {    "type": "clawhub",    "registry": "https://clawhub.openclaw.ai",    "slug": "weather",    "version": "1.0.0"  },  "request": {    "kind": "skill-install",    "mode": "install",    "requestedSpecifier": "clawhub:weather@1.0.0"  },  "skill": {    "installId": "clawhub"  }}

Commande de politique minimale :

#!/usr/bin/env node let input = "";process.stdin.setEncoding("utf8");process.stdin.on("data", (chunk) => {  input += chunk;});process.stdin.on("end", () => {  const request = JSON.parse(input);  if (request.targetType === "plugin" && request.source?.kind === "local-path") {    process.stdout.write(      JSON.stringify({        protocolVersion: 1,        decision: "block",        reason: "local plugin paths are not approved on this host",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Liste d’autorisation des Skills intégrés

Entrées par Skill (skills.entries)

Par défaut, les clés sous entries correspondent au name du Skill. Si un Skill définit metadata.openclaw.skillKey, utilisez plutôt cette clé. Placez les noms contenant des traits d’union entre guillemets (JSON5 autorise les clés entre guillemets).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false désactive le Skill même s’il est intégré ou installé. Le Skill intégré coding-agent doit être activé explicitement — définissez-le sur true et vérifiez que claude, codex, opencode ou une autre CLI prise en charge est installée et authentifiée.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Champ pratique pour les Skills qui déclarent metadata.openclaw.primaryEnv. Accepte une chaîne en texte brut ou une référence de secret SecretRef : { source: "env", provider: "default", id: "VAR_NAME" }.

Listes d’autorisation des agents (agents)

Utilisez la configuration des agents lorsque vous souhaitez conserver les mêmes racines de Skills pour la machine ou l’espace de travail, mais exposer un ensemble de Skills différent à 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    ],  },}

Atelier (skills.workshop)

Consultez Skill Workshop pour le cycle de vie des propositions, les commandes CLI, les paramètres des outils d’agent et les méthodes du Gateway contrôlés par cette configuration.

Racines de Skills liées symboliquement

Par défaut, les racines de Skills de l’espace de travail, de l’agent de projet, des répertoires supplémentaires et des Skills intégrés constituent des limites de confinement. Un dossier de Skill lié symboliquement sous <workspace>/skills et résolu en dehors de la racine est ignoré avec un message dans le journal.

Pour autoriser intentionnellement une organisation avec des liens symboliques, déclarez la cible approuvée :

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

Avec cette configuration, <workspace>/skills/manager -> ~/Projects/manager/skills est accepté après résolution du chemin réel. extraDirs analyse directement le dépôt adjacent ; allowSymlinkTargets conserve le chemin lié symboliquement pour les organisations existantes.

Par défaut, l’application par Skill Workshop n’écrit pas via ces liens symboliques. Pour autoriser l’application par Workshop à modifier les Skills sous des cibles de liens symboliques déjà approuvées, activez cette option séparément :

{  skills: {    load: {      allowSymlinkTargets: ["~/Projects/manager/skills"],    },    workshop: {      allowSymlinkTargetWrites: true,    },  },}

Les répertoires gérés ~/.openclaw/skills et personnels ~/.agents/skills acceptent déjà sans condition les liens symboliques vers des répertoires de Skills (le confinement de SKILL.md par Skill s’applique toujours) — allowSymlinkTargets n’est nécessaire que pour les racines de l’espace de travail, des répertoires supplémentaires et de l’agent de projet (<workspace>/.agents/skills).

Skills en bac à sable et variables d’environnement

Transmettez les secrets à un bac à sable Docker avec :

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

Rappel de l’ordre de chargement

workspace/skills      (priorité la plus élevée)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsbundled skillsskills.load.extraDirs (priorité la plus faible)

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

Voir aussi