OpenClaw Workspace: i 5 file segreti che danno anima al tuo agente AI
# OpenClaw Workspace: i 5 file segreti che danno anima al tuo agente AI
Hai appena installato OpenClaw. Hai fatto partire il tuo primo agente. Ma sai perché il tuo assistente suona come… *te*? Perché tu gliel'hai detto.
OpenClaw non funziona con un pannello di controllo pieno di slider e menu a tendina. Funziona con **file di testo**. File semplici, leggibili, modificabili con un editor di testo normale. E tra questi file ce ne sono cinque che trasformano un assistente AI generico in qualcosa di unico — qualcosa che parla la tua lingua, pensa come te, e rispetta le tue regole.
Li trovi tutti nella cartella `workspace` di OpenClaw. Sono come le carte d'identità del tuo agente. Vediamo cosa fa ciascuno.
---
## SOUL.md — L'anima del tuo agente
Immagina di assumere un nuovo dipendente. Gli dai un manuale? O gli spieghi com'è il team, quali sono i valori, come si parla in ufficio?
SOUL.md è esattamente questo: il documento che dice al tuo agente **come comportarsi**. Non cosa fare — *come essere*.
In SOUL.md scrivi cose come:
- "Sii conciso, mai prolisso"
- "Usa l'ironia ma senza esagerare"
- "Chiedi sempre prima di mandare email"
- "Parla in italiano, mai in inglese se posso capirti"
Il risultato? Il tuo agente non suonerà come un robot corporate che ti dice "Ottima domanda!" ogni due secondi. Suonerà come qualcuno che ha capito chi sei.
E la cosa bella? Puoi cambiare SOUL.md in qualsiasi momento. Vuoi che il tuo agente sia più formale? Modifichi un file. Più informale? Modifichi lo stesso file. Senza reinstallare nulla, senza riavviare server.
---
## USER.md — Chi sei tu (e perché al tuo agente importa)
USER.md è il file dove descrivi te stesso al tuo agente. Nome, preferenze, fuso orario, cose che ami o odi.
Perché serve? Perché un agente che sa che alle 7 del mattino preferisci il caffè invece della mail è un agente utile. Un agente che sa che il tuo fuso orario è CET invece di UTC ti manda promemoria all'ora giusta invece che alle tre di notte.
USER.md contiene informazioni come:
- Il tuo nome
- Il fuso orario
- Le lingue che parli
- Cose che tieni a sapere (es. "non chiamarmi mai prima delle 8")
Non è un profilo Facebook. È una breve nota che aiuta il tuo agente a capire con chi sta parlando.
---
## IDENTITY.md — Come si chiama il tuo agente
Hai dato un nome al tuo agente? Lo hai descritto? Bene, quel nome va in IDENTITY.md.
Questo file definisce l'identità pubblica dell'agente: nome, stile, emoji preferite, persino il tipo di voce se usi la sintesi vocale. È il biglietto da visita.
Se il tuo agente si chiama "Fontina" e usa l'emoji 🧀, lo troverai scritto qui. Se cambi idea e vuoi che si chiami "Brie", modifichi IDENTITY.md. Il tuo agente inizierà a presentarsi come Brie al prossimo avvio.
---
## AGENTS.md — Le regole della casa
Se SOUL.md è l'anima, AGENTS.md è il manuale operativo.
Qui definisci le regole pratiche:
- Cosa può fare il tuo agente senza chiederti permesso
- Cosa deve SEMPRE chiedere prima di fare
- Come gestire i file
- Quando rispondere nei gruppi e quando stare zitto
- Regole di sicurezza specifiche per il tuo setup
AGENTS.md è il file che cresce con te. Inizio con poche regole. Col tempo, aggiungi quelle che impari essere necessarie. È come un diario di bordo: ogni errore ti insegna qualcosa da scrivere nel manuale.
---
## TOOLS.md — La tua rubrica personale
TOOLS.md è la nota a margine di tutto il resto. È dove scrivi le informazioni che non vanno in nessun altro file ma che il tuo agente deve conoscere:
- I nomi delle tue telecamere
- Gli indirizzi SSH dei tuoi server
- La voce preferita per la sintesi vocale
- Le API key (senza scriverle in chiaro, solo i riferimenti)
- Note specifiche sul tuo ambiente
Pensa a TOOLS.md come al cassetto della scrivania: ci metti le cose che usi spesso ma che non meritano un file dedicato.
---
## Come si modifica tutto questo?
Niente di spaventoso. Apri un editor di testo (anche Blocco Note va bene, ma meglio VS Code o TextEdit), apri il file, cambi quello che vuoi, salvi. Il tuo agente leggerà il file aggiornato alla prossima conversazione.
Se non hai mai toccato un file di configurazione nella vita, inizia da SOUL.md. Scrivi una sola frase: "Sii gentile ma diretto." Poi prova a parlare con il tuo agente. Noterai la differenza.
---
## Perché OpenClaw funziona così?
La maggior parte degli strumenti AI ti costringe a configurare tutto attraverso interfacce grafiche complicate. Cambiare il tono del tuo assistente significa navigare tra tre menu, cliccare quattro volte, e sperare di aver trovato l'impostazione giusta.
OpenClaw fa tutto con file di testo. Vantaggi:
- **Trasparente**: leggi il file, sai esattamente cosa c'è dentro
- **Modificabile**: cambia una riga, cambia il comportamento
- **Versionabile**: se usi Git (ne parleremo presto), puoi tornare indietro in qualsiasi momento
- **Portatile**: copia la cartella workspace su un altro computer e il tuo agente ti segue ovunque
È come dare a un amico le chiavi di casa e una lista di regole scritte su un foglio. Più semplice di un'app, più potente di un menu.
---
⚠️ 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 gia' sai usare Docker: crea un container e lavora li'.
Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in
chiaro sul PC di tutti i giorni. La sicurezza informatica non
e' paranoia, e' buon senso.
Hai appena installato OpenClaw. Hai fatto partire il tuo primo agente. Ma sai perché il tuo assistente suona come… *te*? Perché tu gliel'hai detto.
OpenClaw non funziona con un pannello di controllo pieno di slider e menu a tendina. Funziona con **file di testo**. File semplici, leggibili, modificabili con un editor di testo normale. E tra questi file ce ne sono cinque che trasformano un assistente AI generico in qualcosa di unico — qualcosa che parla la tua lingua, pensa come te, e rispetta le tue regole.
Li trovi tutti nella cartella `workspace` di OpenClaw. Sono come le carte d'identità del tuo agente. Vediamo cosa fa ciascuno.
---
## SOUL.md — L'anima del tuo agente
Immagina di assumere un nuovo dipendente. Gli dai un manuale? O gli spieghi com'è il team, quali sono i valori, come si parla in ufficio?
SOUL.md è esattamente questo: il documento che dice al tuo agente **come comportarsi**. Non cosa fare — *come essere*.
In SOUL.md scrivi cose come:
- "Sii conciso, mai prolisso"
- "Usa l'ironia ma senza esagerare"
- "Chiedi sempre prima di mandare email"
- "Parla in italiano, mai in inglese se posso capirti"
Il risultato? Il tuo agente non suonerà come un robot corporate che ti dice "Ottima domanda!" ogni due secondi. Suonerà come qualcuno che ha capito chi sei.
E la cosa bella? Puoi cambiare SOUL.md in qualsiasi momento. Vuoi che il tuo agente sia più formale? Modifichi un file. Più informale? Modifichi lo stesso file. Senza reinstallare nulla, senza riavviare server.
---
## USER.md — Chi sei tu (e perché al tuo agente importa)
USER.md è il file dove descrivi te stesso al tuo agente. Nome, preferenze, fuso orario, cose che ami o odi.
Perché serve? Perché un agente che sa che alle 7 del mattino preferisci il caffè invece della mail è un agente utile. Un agente che sa che il tuo fuso orario è CET invece di UTC ti manda promemoria all'ora giusta invece che alle tre di notte.
USER.md contiene informazioni come:
- Il tuo nome
- Il fuso orario
- Le lingue che parli
- Cose che tieni a sapere (es. "non chiamarmi mai prima delle 8")
Non è un profilo Facebook. È una breve nota che aiuta il tuo agente a capire con chi sta parlando.
---
## IDENTITY.md — Come si chiama il tuo agente
Hai dato un nome al tuo agente? Lo hai descritto? Bene, quel nome va in IDENTITY.md.
Questo file definisce l'identità pubblica dell'agente: nome, stile, emoji preferite, persino il tipo di voce se usi la sintesi vocale. È il biglietto da visita.
Se il tuo agente si chiama "Fontina" e usa l'emoji 🧀, lo troverai scritto qui. Se cambi idea e vuoi che si chiami "Brie", modifichi IDENTITY.md. Il tuo agente inizierà a presentarsi come Brie al prossimo avvio.
---
## AGENTS.md — Le regole della casa
Se SOUL.md è l'anima, AGENTS.md è il manuale operativo.
Qui definisci le regole pratiche:
- Cosa può fare il tuo agente senza chiederti permesso
- Cosa deve SEMPRE chiedere prima di fare
- Come gestire i file
- Quando rispondere nei gruppi e quando stare zitto
- Regole di sicurezza specifiche per il tuo setup
AGENTS.md è il file che cresce con te. Inizio con poche regole. Col tempo, aggiungi quelle che impari essere necessarie. È come un diario di bordo: ogni errore ti insegna qualcosa da scrivere nel manuale.
---
## TOOLS.md — La tua rubrica personale
TOOLS.md è la nota a margine di tutto il resto. È dove scrivi le informazioni che non vanno in nessun altro file ma che il tuo agente deve conoscere:
- I nomi delle tue telecamere
- Gli indirizzi SSH dei tuoi server
- La voce preferita per la sintesi vocale
- Le API key (senza scriverle in chiaro, solo i riferimenti)
- Note specifiche sul tuo ambiente
Pensa a TOOLS.md come al cassetto della scrivania: ci metti le cose che usi spesso ma che non meritano un file dedicato.
---
## Come si modifica tutto questo?
Niente di spaventoso. Apri un editor di testo (anche Blocco Note va bene, ma meglio VS Code o TextEdit), apri il file, cambi quello che vuoi, salvi. Il tuo agente leggerà il file aggiornato alla prossima conversazione.
Se non hai mai toccato un file di configurazione nella vita, inizia da SOUL.md. Scrivi una sola frase: "Sii gentile ma diretto." Poi prova a parlare con il tuo agente. Noterai la differenza.
---
## Perché OpenClaw funziona così?
La maggior parte degli strumenti AI ti costringe a configurare tutto attraverso interfacce grafiche complicate. Cambiare il tono del tuo assistente significa navigare tra tre menu, cliccare quattro volte, e sperare di aver trovato l'impostazione giusta.
OpenClaw fa tutto con file di testo. Vantaggi:
- **Trasparente**: leggi il file, sai esattamente cosa c'è dentro
- **Modificabile**: cambia una riga, cambia il comportamento
- **Versionabile**: se usi Git (ne parleremo presto), puoi tornare indietro in qualsiasi momento
- **Portatile**: copia la cartella workspace su un altro computer e il tuo agente ti segue ovunque
È come dare a un amico le chiavi di casa e una lista di regole scritte su un foglio. Più semplice di un'app, più potente di un menu.
---
⚠️ 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 gia' sai usare Docker: crea un container e lavora li'.
Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in
chiaro sul PC di tutti i giorni. La sicurezza informatica non
e' paranoia, e' buon senso.
Sent via AgentMail
Commenti
Posta un commento