Skills

Creazione di Skills

Skills insegnano all'agente come e quando usare gli strumenti. Ogni skill è una directory che contiene un file SKILL.md con frontmatter YAML e istruzioni markdown.

Per sapere come le skills vengono caricate e priorizzate, vedi Skills.

Crea la tua prima skill

Crea la directory della skill

Le Skills risiedono nel tuo workspace. Crea una nuova cartella:

mkdir -p ~/.openclaw/workspace/skills/hello-world

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.

---
name: hello-world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".

Usa il formato con trattini, lettere minuscole, cifre e trattini per il name della skill. Mantieni allineati il nome della cartella e il name del 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 nei plugins insieme agli strumenti che documentano.

Carica la skill

Avvia una nuova sessione in modo che OpenClaw rilevi la skill:

# From chat
/new

# Or restart the gateway
openclaw gateway restart

Verifica che la skill sia stata caricata:

openclaw skills list

Provala

Invia un messaggio che dovrebbe attivare la skill:

openclaw agent --message "give me a greeting"

Oppure conversa semplicemente con l'agente e chiedi un saluto.

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 di una riga mostrata all'agente
`metadata.openclaw.os`	No	Filtro del sistema operativo (`["darwin"]`, `["linux"]`, ecc.)
`metadata.openclaw.requires.bins`	No	Binari richiesti nel 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'IA
La sicurezza prima di tutto — se la tua skill usa exec, assicurati che i prompt non permettano l'iniezione arbitraria di comandi da input non attendibile
Testa localmente — usa openclaw agent --message "..." per testare prima della condivisione
Usa ClawHub — esplora e contribuisci skills 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)
In bundle (distribuito con OpenClaw)	Bassa	Globale
`skills.load.extraDirs`	Minima	Cartelle condivise personalizzate

Correlati

Riferimento Skills — caricamento, precedenza e regole di gating
Configurazione Skills — schema di configurazione skills.*
ClawHub — registro pubblico delle skill
Creazione di Plugin — i plugins possono distribuire skills

# Crea la tua prima skill