Skills insegna all’agente come e quando usare gli strumenti. Ogni skill è una directory contenente un fileDocumentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
SKILL.md con frontmatter YAML e istruzioni markdown.
Per sapere come vengono caricate e prioritarizzate le Skills, consulta Skills.
Crea la tua prima skill
Scrivi SKILL.md
Crea Usa il formato con trattini, lettere minuscole, cifre e trattini per il
SKILL.md dentro quella directory. Il frontmatter definisce i metadati,
e il corpo markdown contiene le istruzioni per l’agente.name
della skill. Mantieni allineati il nome della cartella e il name nel frontmatter.Aggiungi strumenti (facoltativo)
Puoi definire schemi di strumenti personalizzati nel frontmatter o istruire l’agente
a usare strumenti di sistema esistenti (come
exec o browser). Le Skills possono anche
essere distribuite dentro i 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:| Campo | Obbligatorio | Descrizione |
|---|---|---|
name | Sì | Identificatore univoco con lettere minuscole, cifre e trattini |
description | Sì | Descrizione su una riga mostrata all’agente |
metadata.openclaw.os | No | Filtro OS (["darwin"], ["linux"], ecc.) |
metadata.openclaw.requires.bins | No | Binari richiesti su PATH |
metadata.openclaw.requires.config | No | Chiavi di configurazione richieste |
Buone pratiche
- Sii conciso — istruisci il modello su cosa fare, non su come essere un’AI
- La sicurezza prima di tutto — se la tua skill usa
exec, assicurati che i prompt non consentano l’iniezione arbitraria di comandi da input non attendibile - Testa localmente — usa
openclaw agent --message "..."per testare prima di condividere - Usa ClawHub — esplora e contribuisci con skill su ClawHub
Dove risiedono le Skills
| Posizione | Precedenza | Ambito |
|---|---|---|
\<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) |
| Integrate (distribuite con OpenClaw) | Bassa | Globale |
skills.load.extraDirs | Minima | Cartelle condivise personalizzate |
Correlati
- Riferimento Skills — regole di caricamento, precedenza e gating
- Configurazione Skills — schema di configurazione
skills.* - ClawHub — registro pubblico delle skill
- Creare Plugin — i Plugin possono distribuire skill