Skills

Creare Skills

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

Per sapere come vengono caricate e prioritarizzate le Skills, consulta Skills.

Crea la tua prima skill

Crea la directory della skill

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

bash

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

Scrivi SKILL.md

Crea SKILL.md dentro quella directory. Il frontmatter definisce i metadati, e il corpo markdown contiene le istruzioni per l'agente.

markdown

---name: hello-worlddescription: 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 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:

bash

# From chat/new # Or restart the gatewayopenclaw gateway restart

Verifica che la skill sia stata caricata:

bash

openclaw skills list

Testala

Invia un messaggio che dovrebbe attivare la skill:

bash

openclaw agent --message "give me a greeting"

Oppure chatta 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 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

Was this useful?