Skills

• Ometti agents.defaults.skills per lasciare tutte le Skills non limitate per impostazione predefinita.
• Ometti agents.list[].skills per ereditare agents.defaults.skills.
• Imposta agents.list[].skills: [] per non esporre alcuna skill a quell'agente.
• Una lista agents.list[].skills non vuota è l'insieme finale: non viene unita ai valori predefiniti.
• L'allowlist effettiva si applica alla costruzione dei prompt, al rilevamento dei comandi slash, alla sincronizzazione della sandbox e agli snapshot delle skill.
• Questo non è un limite di autorizzazione della shell host. Se lo stesso agente può usare exec, limita quella shell separatamente con sandboxing, isolamento dell'utente OS, denylist/allowlist di exec e credenziali per risorsa.

openclaw skills install installa per impostazione predefinita nella directory skills/ dell'area di lavoro attiva. Aggiungi --global per installare nella directory condivisa ~/.openclaw/skills, visibile a tutti gli agenti locali salvo restringimenti tramite allowlist degli agenti.

Le installazioni Git e locali si aspettano SKILL.md nella radice della sorgente. Lo slug deriva dal frontmatter name di SKILL.md quando valido, poi ripiega sul nome della directory o del repository. Usa --as <slug> per sovrascriverlo. openclaw skills update tiene traccia solo delle installazioni ClawHub: reinstalla le sorgenti Git o locali per aggiornarle.

openclaw skills verify @owner/<slug> chiede a ClawHub l'involucro di fiducia clawhub.skill.verify.v1 della skill. Le skill ClawHub installate vengono verificate rispetto alla versione e al registro registrati in .clawhub/origin.json. Gli slug semplici restano accettati per skill esistenti installate o non ambigue, ma i riferimenti qualificati con il proprietario evitano ambiguità sull'editore.

Le pagine delle skill ClawHub espongono lo stato dell'ultima scansione di sicurezza prima dell'installazione, con pagine di dettaglio per VirusTotal, ClawScan e analisi statica. Il comando termina con codice non zero quando ClawHub contrassegna la verifica come non riuscita. Gli editori recuperano i falsi positivi tramite la dashboard ClawHub o clawhub skill rescan @owner/<slug>.

I client Gateway che richiedono una distribuzione non ClawHub possono preparare un archivio zip di skill con skills.upload.begin, skills.upload.chunk e skills.upload.commit, quindi installare con skills.install({ source: "upload", ... }). Questo percorso è disattivato per impostazione predefinita e richiede skills.install.allowUploadedArchives: true in openclaw.json. Le normali installazioni ClawHub non hanno mai bisogno di questa impostazione.

Il rilevamento delle skill dell'area di lavoro, dell'agente di progetto e delle directory extra accetta solo radici di skill il cui realpath risolto resta dentro la radice configurata, salvo che skills.load.allowSymlinkTargets consideri esplicitamente attendibile una radice di destinazione. Skill Workshop scrive attraverso quelle destinazioni attendibili solo quando skills.workshop.allowSymlinkTargetWrites è abilitato. Le directory gestite ~/.openclaw/skills e personali ~/.agents/skills possono contenere cartelle skill con symlink, ma ogni realpath di SKILL.md deve comunque restare dentro la directory skill risolta.

Configura security.installPolicy per eseguire un comando di policy locale attendibile prima che le installazioni di skill continuino. La policy riceve metadati e percorso della sorgente preparata, si applica ai percorsi ClawHub, caricati, Git, locali, di aggiornamento e di installazione dipendenze, e fallisce in modo chiuso quando il comando non può restituire una decisione valida.

skills.entries.*.env e skills.entries.*.apiKey iniettano segreti nel processo host solo per quel turno dell'agente, non nella sandbox. Tieni i segreti fuori da prompt e log.

• Quando sono elencati più installer, il Gateway sceglie una opzione preferita (brew quando disponibile, altrimenti node).
• Se tutti gli installer sono download, OpenClaw elenca ogni voce così puoi vedere tutti gli artefatti disponibili.
• Le specifiche possono includere os: ["darwin"|"linux"|"win32"] per filtrare per piattaforma.
• Le installazioni Node rispettano skills.install.nodeManager in openclaw.json (predefinito: npm; opzioni: npm / pnpm / yarn / bun). Questo influisce solo sulle installazioni delle skill; il runtime Gateway dovrebbe rimanere Node.
• Preferenza degli installer del Gateway: Homebrew → uv → gestore node configurato → go → download.

• Homebrew: OpenClaw non installa automaticamente Homebrew né traduce le formule brew in comandi dei pacchetti di sistema. Nei container Linux senza brew, gli installer solo brew sono nascosti; usa un'immagine personalizzata o installa manualmente la dipendenza.
• Go: OpenClaw richiede Go 1.21 o versione successiva per le installazioni automatiche delle skill e conserva le impostazioni esistenti di GOBIN, GOPATH e GOTOOLCHAIN. Se la toolchain configurata non può soddisfare la versione di Go richiesta da un modulo, l'onboarding raggruppa la skill con i prerequisiti Go manuali dopo il tentativo di installazione. Se go manca e Homebrew è disponibile, OpenClaw installa prima Go tramite Homebrew e imposta GOBIN sul bin di Homebrew. Su Linux, OpenClaw può invece usare apt-get come root o tramite sudo senza password quando il candidato golang-go aggiornato soddisfa la versione minima.
• Download: url (obbligatorio), archive (tar.gz | tar.bz2 | zip), extract (predefinito: automatico quando viene rilevato un archivio), stripComponents, targetDir (predefinito: ~/.openclaw/tools/<skillKey>).

requires.bins viene controllato sull'host al momento del caricamento della skill. Se un agente viene eseguito in una sandbox, il binario deve esistere anche dentro il container. Installalo tramite agents.defaults.sandbox.docker.setupCommand o un'immagine personalizzata. setupCommand viene eseguito una volta dopo la creazione del container e richiede uscita di rete, un file system root scrivibile e un utente root nella sandbox.

Per impostazione predefinita, OpenClaw osserva le cartelle delle skill e incrementa lo snapshot quando i file SKILL.md cambiano. Configura sotto skills.load:

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },  },}

Usa allowSymlinkTargets per layout con collegamenti simbolici intenzionali in cui un collegamento simbolico alla radice di una skill punta fuori dalla radice configurata, per esempio <workspace>/skills/manager -> ~/Projects/manager/skills. Abilita skills.workshop.allowSymlinkTargetWrites solo quando Skill Workshop deve applicare proposte anche tramite quei percorsi con collegamenti simbolici attendibili.

Se il Gateway viene eseguito su Linux ma è connesso un nodo macOS con system.run consentito, OpenClaw può trattare le skill solo macOS come idonee quando i binari richiesti sono presenti su quel nodo. L'agente dovrebbe eseguire quelle skill tramite lo strumento exec con host=node.

I nodi offline non rendono visibili le skill solo remote. Se un nodo smette di rispondere alle sonde dei binari, OpenClaw cancella le corrispondenze binarie memorizzate nella cache.