Configurazione delle Skills

La maggior parte della configurazione delle Skills 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: "auto",      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)

Criteri di installazione dell'operatore (security.installPolicy)

Usare security.installPolicy quando gli operatori necessitano di un comando locale attendibile per approvare o bloccare le installazioni di Skills e Plugin in base a criteri specifici dell'host. I criteri vengono eseguiti dopo che OpenClaw ha preparato il materiale sorgente e prima che l'installazione o l'aggiornamento prosegua. Si applicano alle Skills di ClawHub, alle Skills caricate, alle Skills Git/locali, ai programmi di installazione delle dipendenze delle Skills e alle origini di installazione/aggiornamento dei Plugin.

{  security: {    installPolicy: {      enabled: true,      // Omettere targets per includere ogni destinazione supportata.      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"],      },    },  },}

I criteri ricevono su stdin un oggetto JSON contenente protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, il valore strutturato facoltativo source, il valore strutturato origin e request. Devono scrivere un oggetto JSON su stdout: { "protocolVersion": 1, "decision": "allow" } oppure { "protocolVersion": 1, "decision": "block", "reason": "..." }. Un codice di uscita diverso da zero, un timeout, JSON non valido, campi mancanti o versioni del protocollo non supportate comportano il blocco per impostazione predefinita.

OpenClaw non esegue i criteri di installazione durante il normale avvio del Gateway. Le installazioni e gli aggiornamenti vengono bloccati per impostazione predefinita quando i criteri sono abilitati ma non disponibili. openclaw doctor esegue la convalida statica; openclaw doctor --deep esegue una verifica sintetica dell'installazione usando il comando configurato.

Gli aggiornamenti in blocco applicano i criteri a ciascuna destinazione: un aggiornamento bloccato di una Skill o di un Plugin non riesce per tale destinazione senza disabilitare i criteri né ignorare le destinazioni successive del gruppo.

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 minimo per i criteri:

#!/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: "i percorsi locali dei plugin non sono approvati su questo host",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Elenco consentito delle Skills incluse

Voci per singola Skill (skills.entries)

Per impostazione predefinita, le chiavi sotto entries corrispondono a name della Skill. Se una Skill definisce metadata.openclaw.skillKey, usare invece tale chiave. Racchiudere tra virgolette i nomi con trattini (JSON5 consente chiavi tra virgolette).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false disabilita la Skill anche se è inclusa o installata. La Skill inclusa coding-agent richiede l'abilitazione esplicita: impostarla su true e assicurarsi che claude, codex, opencode o un'altra CLI supportata sia installata e autenticata.

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

Elenchi consentiti degli agenti (agents)

Usare la configurazione dell'agente quando si desiderano le stesse radici delle Skills della macchina/dello spazio di lavoro, ma un insieme diverso di Skills visibili per ciascun agente.

{  agents: {    defaults: {      skills: ["github", "weather"], // base condivisa    },    list: [      { id: "writer" }, // eredita github, weather      { id: "docs", skills: ["docs-search"] }, // sostituisce completamente i valori predefiniti      { id: "locked-down", skills: [] }, // nessuna Skill    ],  },}

Workshop (skills.workshop)

Consultare Autoapprendimento per idoneità, privacy, costi, autorizzazioni limitate alle proposte e risoluzione dei problemi.

Consultare Skill Workshop per il ciclo di vita delle proposte, i comandi CLI, i parametri degli strumenti dell'agente e i metodi del Gateway controllati da questa configurazione.

Radici delle skill con collegamenti simbolici

Per impostazione predefinita, le radici delle skill dell'area di lavoro, dell'agente di progetto, delle directory aggiuntive e di quelle incluse costituiscono limiti di contenimento. Una cartella di skill con collegamento simbolico sotto <workspace>/skills che viene risolta all'esterno della radice viene ignorata con un messaggio nel log.

Per consentire una struttura intenzionale di collegamenti simbolici, dichiarare attendibile la destinazione:

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

Con questa configurazione, <workspace>/skills/manager -> ~/Projects/manager/skills viene accettato dopo la risoluzione del percorso reale. extraDirs analizza direttamente il repository adiacente; allowSymlinkTargets conserva il percorso con collegamento simbolico per le strutture esistenti.

Per impostazione predefinita, l'applicazione di Skill Workshop non scrive attraverso questi collegamenti simbolici. Per consentire all'applicazione di Workshop di modificare le skill nelle destinazioni con collegamenti simbolici già considerate attendibili, abilitare separatamente questa opzione:

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

Le directory gestite ~/.openclaw/skills e personali ~/.agents/skills accettano già incondizionatamente i collegamenti simbolici alle directory delle skill (il contenimento SKILL.md per singola skill continua ad applicarsi) — allowSymlinkTargets è necessario solo per le radici dell'area di lavoro, delle directory aggiuntive e dell'agente di progetto (<workspace>/.agents/skills).

Skill in sandbox e variabili di ambiente

Passare i segreti a una sandbox Docker con:

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

Promemoria sull'ordine di caricamento

workspace/skills      (priorità massima)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsskill incluseskills.load.extraDirs (priorità minima)

Le modifiche alle skill e alla configurazione hanno effetto nella successiva nuova sessione quando il monitoraggio è abilitato, oppure nel turno successivo dell'agente quando il monitoraggio rileva una modifica.

Contenuti correlati