Configuration Skills

La majeure partie de la configuration des Skills se trouve sous skills dans ~/.openclaw/openclaw.json. La visibilité propre aux agents 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 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 avec une politique propre à l’hôte. La politique s’exécute après qu’OpenClaw a préparé les sources et avant que l’installation ou la mise à jour ne continue. Elle s’applique aux Skills ClawHub, aux Skills téléversés, aux Skills Git/locaux, aux installateurs de dépendances de Skills et aux sources d’installation/mise à jour de 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 un objet JSON sur stdin avec protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, un champ structuré facultatif source, ainsi que origin et request structurés. Elle doit écrire un objet JSON sur stdout : { "protocolVersion": 1, "decision": "allow" } ou { "protocolVersion": 1, "decision": "block", "reason": "..." }. Une sortie non nulle, un délai d’expiration, un JSON mal formé, des champs manquants ou des versions de protocole non prises en charge échouent en mode fermé.

OpenClaw n’exécute pas la politique d’installation pendant le démarrage normal du Gateway. Les installations et mises à jour échouent en mode fermé lorsque la politique est activée mais indisponible. openclaw doctor effectue une validation statique, et openclaw doctor --deep exécute une sonde d’installation synthétique contre la commande configurée.

Les mises à jour en masse appliquent la politique par cible : une mise à jour de Skill ou de Plugin bloquée échoue pour cette cible sans désactiver la politique ni ignorer les cibles suivantes du lot.

Exemple stdin :

{  "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 groupés

Entrées par Skill (skills.entries)

Les clés sous entries correspondent par défaut au name du Skill. Si un Skill définit metadata.openclaw.skillKey, utilisez cette clé à la place. Mettez les noms avec trait 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 lorsqu’il est groupé ou installé. Le Skill groupé coding-agent est opt-in — définissez-le sur true et assurez-vous que l’un de claude, codex, opencode ou une autre CLI prise en charge est installé et authentifié.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Champ pratique pour les Skills qui déclarent metadata.openclaw.primaryEnv. Prend en charge une chaîne en clair ou un SecretRef : { source: "env", provider: "default", id: "VAR_NAME" }.

Listes d’autorisation des agents (agents)

Utilisez la configuration d’agent lorsque vous voulez les mêmes racines de Skills pour une machine/un espace de travail, mais un ensemble de Skills visible différent par 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    ],  },}

Workshop (skills.workshop)

Racines de Skills liées par lien symbolique

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é par lien symbolique sous <workspace>/skills qui se résout en dehors de la racine est ignoré avec un message de journal.

Pour autoriser une disposition intentionnelle avec lien symbolique, 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 realpath. extraDirs analyse directement le dépôt voisin ; allowSymlinkTargets préserve le chemin lié par lien symbolique pour les dispositions existantes.

Par défaut, l’application de Skill Workshop n’écrit pas à travers ces liens symboliques. Pour permettre à Workshop apply de modifier des 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à les liens symboliques de répertoires de Skills (le confinement SKILL.md par Skill s’applique toujours).

Skills sandboxés et variables d’environnement

Transmettez des secrets à 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/skillsbundled skillsskills.load.extraDirs (lowest)

Les modifications apportées aux Skills et à la configuration prennent effet lors de la nouvelle session suivante lorsque le watcher est activé, ou lors du tour d’agent suivant lorsque le watcher détecte une modification.

Associés