OpenClaw Skills Personalizzate: Come Creare i Tuoi Superpoteri (Senza Saper Programmare)
# OPENCLAW SKILLS PERSONALIZZATE: COME CREARE I TUOI SUPERPOTERI (SENZA SAPER PROGRAMMARE)
Hai mai desiderato che il tuo agente AI facesse una cosa specifica che nessuno ha ancora immaginato? Magari controllare il meteo ogni mattina e mandarti un messaggio con l'abbigliamento consigliato, oppure ordinare la spesa quando il frigo è vuoto.
**Le skill personalizzate di OpenClaw** sono la risposta. Sono come istruzioni che scrivi tu per dire al tuo agente: "Ehi, quando succede X, fai Y in questo modo preciso."
Niente codice complesso. Niente linguaggi strani. Solo un file di testo chiamato `SKILL.md` e la pazienza di spiegare cosa vuoi.
## COSA SONO LE SKILL, SPIEGATO SEMPLICE
Immagina che il tuo agente OpenClaw sia un maggiordomo intelligente. Di default sa fare tante cose: leggere file, cercare sul web, mandare messaggi. Ma se volesse fare qualcosa di particolare che non conosce ancora?
La skill è come una scheda istruzioni che gli lasci sulla scrivania. Gli spieghi: "Quando il cliente chiede il meteo, fai queste cose precise, in quest'ordine, usando questi strumenti."
Una skill è una cartella con dentro un file chiamato `SKILL.md`. Dentro quel file ci sono due cose:
1. **I metadati** — nome e descrizione (come il nome e la bio di un profilo)
2. **Le istruzioni** — passo dopo passo cosa fare e quando farlo
È tutto qui. Non serve essere programmatori. Serve solo sapere cosa vuoi che il tuo agente faccia.
## PERCHÉ LE SKILL CONTANO
Senza skill personalizzate, il tuo agente fa solo quello che sa già fare. Con le skill, puoi trasformarlo in:
- Un assistente meteo personale che ti manda il bollettino ogni mattina
- Un gestore di ricette che cerca piatti con gli ingredienti che hai in casa
- Un guardiano del budget che controlla le spese e ti avvisa quando superi il limite
- Un organizzatore di appuntamenti che legge le email e propone slot liberi
Le skill trasformano un agente generico in un agente *tuo*. Personalizzato. Su misura. Come un vestito fatto da un sarto invece che comprato al supermercato.
## COME CREARE LA TUA PRIMA SKILL: PASSO PER PASSO
### PASSO 1 — Crea la cartella della skill
OpenClaw tiene tutte le skill in una cartella speciale chiamata `skills/`, dentro il tuo workspace. Per crearne una nuova, apri il terminale (quella finestra nera dove scrivi comandi) e scrivi:
```bash
mkdir -p ~/.openclaw/workspace/skills/il-mio-primo-skill
```
Cosa significa? `mkdir` sta per "make directory" — crea una cartella. `-p` serve a creare anche le cartelle genitori se non esistono. Il percorso dice "vai nella cartella skills di OpenClaw e creaci una sottocartella chiamata il-mio-primo-skill".
**Regola importante:** il nome della cartella deve usare solo lettere minuscole, numeri e trattini. Niente spazi, niente caratteri strani. Pensa a un nome URL: tutto attaccato, minuscolo, con trattini al posto degli spazi.
### PASSO 2 — Scrivi il file SKILL.md
Dentro la cartella appena creata, crea un file chiamato esattamente `SKILL.md` (con la M maiuscola). Puoi usarare un editor di testo normale — Blocco Note su Windows, TextEdit su Mac, o qualsiasi cosa.
Il contenuto deve avere questa struttura:
```markdown
---
name: il-mio-primo-skill
description: Una skill semplice che saluta l'utente con un messaggio personalizzato.
---
# Il Mio Primo Skill
Quando l'utente chiede un saluto personalizzato, usa lo strumento exec per eseguire:
```bash
echo "Buongiorno! Oggi è un ottimo giorno per iniziare qualcosa di nuovo."
```
Se l'utente chiede un saluto serale, usa invece:
```bash
echo "Buonasera! Hai lavorato duramente oggi. Meriti una pausa."
```
```
Analizziamo pezzo per pezzo:
- **`---`** — indica l'inizio dei metadati (le informazioni tecniche)
- **`name:`** — il nome unico della skill. Deve essere minuscolo con trattini
- **`description:`** — una riga che spiega cosa fa. L'agente la usa per capire quando invocarla
- **`---`** — indica la fine dei metadati e l'inizio delle istruzioni
- **Il resto** — le istruzioni vere e proprie, scritte in italiano naturale
### PASSO 3 — Fai riconoscere la skill ad OpenClaw
Dopo aver creato il file, OpenClaw dovrebbe accorgersene automaticamente. Se non succede, hai due opzioni:
**Opzione A — Ricomincia la chat:**
Nel terminale, digita `/new`. Questo archivia la conversazione attuale e ne inizia una nuova, dove OpenClaw ricarica la lista delle skill.
**Opzione B — Riavvia il gateway:**
Nel terminale, digita:
```bash
openclaw gateway restart
```
Questo riavvia il servizio principale di OpenClaw. È come riavviare un computer: veloce e sicuro.
### PASSO 4 — Testa la tua skill
Ora viene la parte divertente. Apri la chat con il tuo agente e prova a chiedergli qualcosa che rientra nelle sue istruzioni.
Se hai seguito l'esempio sopra, prova a dire: "Fammi un saluto!" o "Buongiorno!".
L'agente dovrebbe leggere le tue istruzioni nella SKILL.md ed eseguirle. Se funziona, congratulazioni — hai appena creato la tua prima skill!
## COME FUNZIONANO LE CONDIZIONI (QUANDO ATTIVARE LA SKILL)
Non tutte le skill devono essere sempre attive. Alcune hanno bisogno di programmi specifici installati, altre di chiavi API, altre funzionano solo su certi sistemi operativi.
OpenClaw permette di "blindare" le skill con delle condizioni. Ecco un esempio:
```markdown
---
name: ricerca-gemini
description: Cerca usando Gemini CLI.
metadata:
openclaw:
requires:
bins: ["gemini"]
env: ["GEMINI_API_KEY"]
---
```
In parole povere: questa skill si attiva SOLO se:
- Il programma `gemini` è installato sul computer
- Esiste la variabile d'ambiente `GEMINI_API_KEY` (dove tieni la tua chiave API)
Altrimenti, OpenClaw la ignora silenziosamente. Non dà errori. Non rompe nulla. Si limita a non mostrarla.
Altre condizioni possibili:
- **`os`** — funziona solo su macOS, Linux o Windows
- **`always: true`** — forza l'attivazione, ignorando tutti i controlli
## PUBBLICARE LE TUE SKILL CON GLI ALTRI
Quando crei una skill che pensi possa essere utile anche ad altri, puoi pubblicarla su ClawHub, il mercato delle skill di OpenClaw.
Per farlo servono tre passi:
1. Assicurati che la SKILL.md sia completa (nome, descrizione, eventuali condizioni)
2. Installa ClawHub: `npm i -g clawhub` e fai il login con `clawhub login`
3. Pubblica: `clawhub skill publish ./percorso/della/tua/skill`
Gli altri utenti potranno installarla con un comando e renderla loro. È così semplice condividere creatività.
## ERRORI COMUNI (E COME RISOLVERLI)
**"La mia skill non appare!"**
Verifica che il nome della cartella e il campo `name` nel frontmatter siano identici. Controlla anche di aver usato solo lettere minuscole e trattini.
**"L'agente ignora le mie istruzioni!"**
Ricomincia la chat con `/new` o riavvia il gateway. A volte OpenClaw non ricarica le skill senza un reset.
**"Ho sbagliato nome e ora ho due skill uguali!"**
Elimina la cartella sbagliata con `trash ~/.openclaw/workspace/skills/nome-sbagliato` e ricomincia.
**"La skill richiede un programma che non ho!"**
Controlla la sezione `requires` nel frontmatter. Se non ti serve quella condizione, rimuovila.
## PROSSIMI PASSI: DARE VITA ALLE TUE IDEE
Ora che sai come creare una skill, la domanda è: quale vuoi creare tu?
Forse un sistema che legge le email urgenti e le riassume in una frase. Forse un bot che ti ricorda di bere acqua ogni ora. Forse qualcosa di completamente originale che non hai visto da nessuna parte.
Le skill personalizzate sono il ponte tra "ho un agente AI" e "ho un agente AI che fa proprio quello che voglio io". E il meglio è che non serve essere programmatori per costruirlo.
Basta sapere cosa vuoi, saperlo spiegare in italiano semplice, e avere la pazienza di testare e perfezionare. Come tutto nella vita, del resto.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi tutti i giorni. Usa sempre una macchina virtuale o un container per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass da multipass.run. Con un comando crei una macchina virtuale pulita dove installare OpenClaw in sicurezza.
Se già sai usare Docker: crea un container e lavora lì. Se non sai cos'è Docker: usa Multipass, è più semplice.
La regola è una: OpenClaw su un computer isolato. Mai in chiaro sul PC di tutti i giorni. La sicurezza informatica non è paranoia, è buon senso.
Hai mai desiderato che il tuo agente AI facesse una cosa specifica che nessuno ha ancora immaginato? Magari controllare il meteo ogni mattina e mandarti un messaggio con l'abbigliamento consigliato, oppure ordinare la spesa quando il frigo è vuoto.
**Le skill personalizzate di OpenClaw** sono la risposta. Sono come istruzioni che scrivi tu per dire al tuo agente: "Ehi, quando succede X, fai Y in questo modo preciso."
Niente codice complesso. Niente linguaggi strani. Solo un file di testo chiamato `SKILL.md` e la pazienza di spiegare cosa vuoi.
## COSA SONO LE SKILL, SPIEGATO SEMPLICE
Immagina che il tuo agente OpenClaw sia un maggiordomo intelligente. Di default sa fare tante cose: leggere file, cercare sul web, mandare messaggi. Ma se volesse fare qualcosa di particolare che non conosce ancora?
La skill è come una scheda istruzioni che gli lasci sulla scrivania. Gli spieghi: "Quando il cliente chiede il meteo, fai queste cose precise, in quest'ordine, usando questi strumenti."
Una skill è una cartella con dentro un file chiamato `SKILL.md`. Dentro quel file ci sono due cose:
1. **I metadati** — nome e descrizione (come il nome e la bio di un profilo)
2. **Le istruzioni** — passo dopo passo cosa fare e quando farlo
È tutto qui. Non serve essere programmatori. Serve solo sapere cosa vuoi che il tuo agente faccia.
## PERCHÉ LE SKILL CONTANO
Senza skill personalizzate, il tuo agente fa solo quello che sa già fare. Con le skill, puoi trasformarlo in:
- Un assistente meteo personale che ti manda il bollettino ogni mattina
- Un gestore di ricette che cerca piatti con gli ingredienti che hai in casa
- Un guardiano del budget che controlla le spese e ti avvisa quando superi il limite
- Un organizzatore di appuntamenti che legge le email e propone slot liberi
Le skill trasformano un agente generico in un agente *tuo*. Personalizzato. Su misura. Come un vestito fatto da un sarto invece che comprato al supermercato.
## COME CREARE LA TUA PRIMA SKILL: PASSO PER PASSO
### PASSO 1 — Crea la cartella della skill
OpenClaw tiene tutte le skill in una cartella speciale chiamata `skills/`, dentro il tuo workspace. Per crearne una nuova, apri il terminale (quella finestra nera dove scrivi comandi) e scrivi:
```bash
mkdir -p ~/.openclaw/workspace/skills/il-mio-primo-skill
```
Cosa significa? `mkdir` sta per "make directory" — crea una cartella. `-p` serve a creare anche le cartelle genitori se non esistono. Il percorso dice "vai nella cartella skills di OpenClaw e creaci una sottocartella chiamata il-mio-primo-skill".
**Regola importante:** il nome della cartella deve usare solo lettere minuscole, numeri e trattini. Niente spazi, niente caratteri strani. Pensa a un nome URL: tutto attaccato, minuscolo, con trattini al posto degli spazi.
### PASSO 2 — Scrivi il file SKILL.md
Dentro la cartella appena creata, crea un file chiamato esattamente `SKILL.md` (con la M maiuscola). Puoi usarare un editor di testo normale — Blocco Note su Windows, TextEdit su Mac, o qualsiasi cosa.
Il contenuto deve avere questa struttura:
```markdown
---
name: il-mio-primo-skill
description: Una skill semplice che saluta l'utente con un messaggio personalizzato.
---
# Il Mio Primo Skill
Quando l'utente chiede un saluto personalizzato, usa lo strumento exec per eseguire:
```bash
echo "Buongiorno! Oggi è un ottimo giorno per iniziare qualcosa di nuovo."
```
Se l'utente chiede un saluto serale, usa invece:
```bash
echo "Buonasera! Hai lavorato duramente oggi. Meriti una pausa."
```
```
Analizziamo pezzo per pezzo:
- **`---`** — indica l'inizio dei metadati (le informazioni tecniche)
- **`name:`** — il nome unico della skill. Deve essere minuscolo con trattini
- **`description:`** — una riga che spiega cosa fa. L'agente la usa per capire quando invocarla
- **`---`** — indica la fine dei metadati e l'inizio delle istruzioni
- **Il resto** — le istruzioni vere e proprie, scritte in italiano naturale
### PASSO 3 — Fai riconoscere la skill ad OpenClaw
Dopo aver creato il file, OpenClaw dovrebbe accorgersene automaticamente. Se non succede, hai due opzioni:
**Opzione A — Ricomincia la chat:**
Nel terminale, digita `/new`. Questo archivia la conversazione attuale e ne inizia una nuova, dove OpenClaw ricarica la lista delle skill.
**Opzione B — Riavvia il gateway:**
Nel terminale, digita:
```bash
openclaw gateway restart
```
Questo riavvia il servizio principale di OpenClaw. È come riavviare un computer: veloce e sicuro.
### PASSO 4 — Testa la tua skill
Ora viene la parte divertente. Apri la chat con il tuo agente e prova a chiedergli qualcosa che rientra nelle sue istruzioni.
Se hai seguito l'esempio sopra, prova a dire: "Fammi un saluto!" o "Buongiorno!".
L'agente dovrebbe leggere le tue istruzioni nella SKILL.md ed eseguirle. Se funziona, congratulazioni — hai appena creato la tua prima skill!
## COME FUNZIONANO LE CONDIZIONI (QUANDO ATTIVARE LA SKILL)
Non tutte le skill devono essere sempre attive. Alcune hanno bisogno di programmi specifici installati, altre di chiavi API, altre funzionano solo su certi sistemi operativi.
OpenClaw permette di "blindare" le skill con delle condizioni. Ecco un esempio:
```markdown
---
name: ricerca-gemini
description: Cerca usando Gemini CLI.
metadata:
openclaw:
requires:
bins: ["gemini"]
env: ["GEMINI_API_KEY"]
---
```
In parole povere: questa skill si attiva SOLO se:
- Il programma `gemini` è installato sul computer
- Esiste la variabile d'ambiente `GEMINI_API_KEY` (dove tieni la tua chiave API)
Altrimenti, OpenClaw la ignora silenziosamente. Non dà errori. Non rompe nulla. Si limita a non mostrarla.
Altre condizioni possibili:
- **`os`** — funziona solo su macOS, Linux o Windows
- **`always: true`** — forza l'attivazione, ignorando tutti i controlli
## PUBBLICARE LE TUE SKILL CON GLI ALTRI
Quando crei una skill che pensi possa essere utile anche ad altri, puoi pubblicarla su ClawHub, il mercato delle skill di OpenClaw.
Per farlo servono tre passi:
1. Assicurati che la SKILL.md sia completa (nome, descrizione, eventuali condizioni)
2. Installa ClawHub: `npm i -g clawhub` e fai il login con `clawhub login`
3. Pubblica: `clawhub skill publish ./percorso/della/tua/skill`
Gli altri utenti potranno installarla con un comando e renderla loro. È così semplice condividere creatività.
## ERRORI COMUNI (E COME RISOLVERLI)
**"La mia skill non appare!"**
Verifica che il nome della cartella e il campo `name` nel frontmatter siano identici. Controlla anche di aver usato solo lettere minuscole e trattini.
**"L'agente ignora le mie istruzioni!"**
Ricomincia la chat con `/new` o riavvia il gateway. A volte OpenClaw non ricarica le skill senza un reset.
**"Ho sbagliato nome e ora ho due skill uguali!"**
Elimina la cartella sbagliata con `trash ~/.openclaw/workspace/skills/nome-sbagliato` e ricomincia.
**"La skill richiede un programma che non ho!"**
Controlla la sezione `requires` nel frontmatter. Se non ti serve quella condizione, rimuovila.
## PROSSIMI PASSI: DARE VITA ALLE TUE IDEE
Ora che sai come creare una skill, la domanda è: quale vuoi creare tu?
Forse un sistema che legge le email urgenti e le riassume in una frase. Forse un bot che ti ricorda di bere acqua ogni ora. Forse qualcosa di completamente originale che non hai visto da nessuna parte.
Le skill personalizzate sono il ponte tra "ho un agente AI" e "ho un agente AI che fa proprio quello che voglio io". E il meglio è che non serve essere programmatori per costruirlo.
Basta sapere cosa vuoi, saperlo spiegare in italiano semplice, e avere la pazienza di testare e perfezionare. Come tutto nella vita, del resto.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi tutti i giorni. Usa sempre una macchina virtuale o un container per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass da multipass.run. Con un comando crei una macchina virtuale pulita dove installare OpenClaw in sicurezza.
Se già sai usare Docker: crea un container e lavora lì. Se non sai cos'è Docker: usa Multipass, è più semplice.
La regola è una: OpenClaw su un computer isolato. Mai in chiaro sul PC di tutti i giorni. La sicurezza informatica non è paranoia, è buon senso.
Sent via AgentMail
Commenti
Posta un commento