Creazione delle Skills
Le Skills insegnano all’agente come e quando usare gli strumenti. Ogni Skill è una directory che contiene un fileSKILL.md con frontmatter YAML e istruzioni in markdown.
Per sapere come le Skills vengono caricate e messe in priorità, vedi Skills.
Crea la tua prima Skill
Scrivi SKILL.md
Crea
SKILL.md all’interno di quella directory. Il frontmatter definisce i metadati,
e il corpo markdown contiene le istruzioni per l’agente.Aggiungi strumenti (facoltativo)
Puoi definire schemi di strumenti personalizzati nel frontmatter oppure istruire l’agente
a usare strumenti di sistema esistenti (come
exec o browser). Le Skills possono anche
essere incluse nei plugin insieme agli strumenti che documentano.Carica la Skill
Avvia una nuova sessione in modo che OpenClaw rilevi la Skill:Verifica che la Skill sia stata caricata:
Riferimento dei metadati della Skill
Il frontmatter YAML supporta questi campi:| Field | Required | Description |
|---|---|---|
name | Yes | Identificatore univoco (snake_case) |
description | Yes | Descrizione in una riga mostrata all’agente |
metadata.openclaw.os | No | Filtro OS (["darwin"], ["linux"], ecc.) |
metadata.openclaw.requires.bins | No | Binari richiesti nel PATH |
metadata.openclaw.requires.config | No | Chiavi di configurazione richieste |
Best practice
- Sii conciso — istruisci il modello su cosa fare, non su come comportarsi come un’IA
- Sicurezza prima di tutto — se la tua Skill usa
exec, assicurati che i prompt non consentano iniezioni arbitrarie di comandi da input non attendibili - Testa localmente — usa
openclaw agent --message "..."per testare prima di condividere - Usa ClawHub — esplora e contribuisci alle Skills su ClawHub
Dove si trovano le Skills
| Location | Precedence | Scope |
|---|---|---|
\<workspace\>/skills/ | Massima | Per agente |
\<workspace\>/.agents/skills/ | Alta | Agente per workspace |
~/.agents/skills/ | Media | Profilo agente condiviso |
~/.openclaw/skills/ | Media | Condiviso (tutti gli agenti) |
| Bundled (shipped with OpenClaw) | Bassa | Globale |
skills.load.extraDirs | Minima | Cartelle condivise personalizzate |
Correlati
- Riferimento Skills — caricamento, priorità e regole di gating
- Configurazione Skills — schema di configurazione
skills.* - ClawHub — registro pubblico delle Skills
- Creare plugin — i plugin possono includere Skills