Configurazione Skills

La maggior parte della configurazione delle skill si trova sotto skills in ~/.openclaw/openclaw.json. La visibilità specifica dell'agente si trova sotto agents.defaults.skills e 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 },    },  },}

Caricamento (skills.load)

Installazione (skills.install)

Criterio di installazione dell'operatore (security.installPolicy)

Usa security.installPolicy quando gli operatori hanno bisogno di un comando locale attendibile per approvare o bloccare installazioni di skill e Plugin con criteri specifici dell'host. Il criterio viene eseguito dopo che OpenClaw ha predisposto il materiale sorgente e prima che l'installazione o l'aggiornamento continui. Si applica alle skill ClawHub, alle skill caricate, alle skill Git/locali, agli installer delle dipendenze delle skill e alle sorgenti di installazione/aggiornamento dei Plugin.

{  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"],      },    },  },}

Il criterio riceve un oggetto JSON su stdin con protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, source strutturato facoltativo, origin strutturato e request. Deve scrivere un oggetto JSON su stdout: { "protocolVersion": 1, "decision": "allow" } oppure { "protocolVersion": 1, "decision": "block", "reason": "..." }. Uscita diversa da zero, timeout, JSON malformato, campi mancanti o versioni di protocollo non supportate falliscono in modo chiuso.

OpenClaw non esegue il criterio di installazione durante il normale avvio del Gateway. Installazioni e aggiornamenti falliscono in modo chiuso quando il criterio è abilitato ma non disponibile. openclaw doctor esegue la convalida statica, e openclaw doctor --deep esegue una prova sintetica di installazione contro il comando configurato.

Gli aggiornamenti in blocco applicano il criterio per destinazione: un aggiornamento bloccato di skill o Plugin fallisce per quella destinazione senza disabilitare il criterio o saltare le destinazioni successive nel batch.

Esempio di 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"  }}

Comando di criterio minimo:

#!/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" }));});

Allowlist delle skill in bundle

Voci per skill (skills.entries)

Le chiavi sotto entries corrispondono per impostazione predefinita al name della skill. Se una skill definisce metadata.openclaw.skillKey, usa invece quella chiave. Metti tra virgolette i nomi con trattino (JSON5 consente chiavi tra virgolette).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false disabilita la skill anche quando è in bundle o installata. La skill in bundle coding-agent è opt-in: impostala su true e assicurati che uno tra claude, codex, opencode o un'altra CLI supportata sia installato e autenticato.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Campo di comodità per le skill che dichiarano metadata.openclaw.primaryEnv. Supporta una stringa in testo normale o una SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }.

Allowlist degli agenti (agents)

Usa la configurazione dell'agente quando vuoi le stesse radici di skill di macchina/workspace ma un insieme di skill visibili diverso per agente.

{  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)

Radici Skills con symlink

Per impostazione predefinita, le radici Skills di area di lavoro, agente di progetto, directory extra e incluse sono confini di contenimento. Una cartella Skills con symlink sotto <workspace>/skills che si risolve fuori dalla radice viene ignorata con un messaggio di log.

Per consentire un layout con symlink intenzionale, dichiara il target attendibile:

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

Con questa configurazione, <workspace>/skills/manager -> ~/Projects/manager/skills viene accettato dopo la risoluzione realpath. extraDirs scansiona direttamente il repository adiacente; allowSymlinkTargets conserva il percorso con symlink per i layout esistenti.

Per impostazione predefinita, l'applicazione di Skill Workshop non scrive attraverso quei symlink. Per consentire a Workshop di modificare Skills sotto target symlink già attendibili, abilitalo separatamente:

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

Le directory gestite ~/.openclaw/skills e personali ~/.agents/skills accettano già symlink a directory Skills (il contenimento SKILL.md per singola Skill continua ad applicarsi).

Skills in sandbox e variabili env

Passa i segreti in una sandbox Docker con:

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

Promemoria sull'ordine di caricamento

workspace/skills      (più alto)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsSkills incluseskills.load.extraDirs (più basso)

Le modifiche a Skills e configurazione hanno effetto nella nuova sessione successiva quando il watcher è abilitato, oppure nel turno agente successivo quando il watcher rileva una modifica.

Correlati