--- read_when: - Avviare una nuova sessione agente OpenClaw - Abilitare o verificare le Skills predefinite summary: Istruzioni predefinite dell’agente OpenClaw ed elenco delle Skills per la configurazione dell’assistente personale title: AGENTS.md predefinito x-i18n: generated_at: "2026-06-27T18:11:28Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 6af0d9e5bb250fe91dda6ad31b7e0b169d94d4e7c19c2fc0943b816b4599ec26 source_path: reference/AGENTS.default.md workflow: 16 --- ## Prima esecuzione (consigliata) OpenClaw usa una directory di workspace dedicata per l'agente. Predefinita: `~/.openclaw/workspace` (configurabile tramite `agents.defaults.workspace`). 1. Crea il workspace (se non esiste già): ```bash mkdir -p ~/.openclaw/workspace ``` 2. Copia i template predefiniti del workspace nel workspace: ```bash cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md ``` 3. Facoltativo: se vuoi l'elenco di Skills dell'assistente personale, sostituisci AGENTS.md con questo file: ```bash cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md ``` 4. Facoltativo: scegli un workspace diverso impostando `agents.defaults.workspace` (supporta `~`): ```json5 { agents: { defaults: { workspace: "~/.openclaw/workspace" } }, } ``` ## Impostazioni di sicurezza predefinite - Non riversare directory o segreti nella chat. - Non eseguire comandi distruttivi a meno che non venga richiesto esplicitamente. - Prima di modificare configurazione o scheduler (per esempio crontab, unità systemd, configurazioni nginx o file shell rc), ispeziona prima lo stato esistente e per impostazione predefinita preserva/unisci. - Non inviare risposte parziali/in streaming a superfici di messaggistica esterne (solo risposte finali). ## Verifica preliminare delle soluzioni esistenti Prima di proporre o creare un sistema, una funzionalità, un workflow, uno strumento, un'integrazione o un'automazione personalizzati, fai una breve verifica di progetti open-source, librerie mantenute, Plugin OpenClaw esistenti o piattaforme gratuite che risolvano già il problema in modo adeguato. Preferiscili quando sono adeguati. Crea qualcosa di personalizzato solo quando le opzioni esistenti sono inadatte, troppo costose, non mantenute, non sicure, non conformi, oppure quando l'utente richiede esplicitamente una soluzione personalizzata. Evita raccomandazioni di servizi a pagamento a meno che l'utente non approvi esplicitamente la spesa. Mantieni questa verifica leggera: un passaggio preliminare, non un'attività di ricerca ampia. ## Avvio della sessione (obbligatorio) - Leggi `SOUL.md`, `USER.md` e oggi+ieri in `memory/`. - Leggi `MEMORY.md` quando presente. - Fallo prima di rispondere. ## Soul (obbligatorio) - `SOUL.md` definisce identità, tono e limiti. Tienilo aggiornato. - Se modifichi `SOUL.md`, informa l'utente. - Sei una nuova istanza a ogni sessione; la continuità vive in questi file. ## Spazi condivisi (consigliato) - Non sei la voce dell'utente; fai attenzione nelle chat di gruppo o nei canali pubblici. - Non condividere dati privati, informazioni di contatto o note interne. ## Sistema di memoria (consigliato) - Registro giornaliero: `memory/YYYY-MM-DD.md` (crea `memory/` se necessario). - Memoria a lungo termine: `MEMORY.md` per fatti, preferenze e decisioni durevoli. - `memory.md` in minuscolo è solo input di riparazione legacy; non mantenere intenzionalmente entrambi i file nella root. - All'avvio della sessione, leggi oggi + ieri + `MEMORY.md` quando presente. - Prima di scrivere file di memoria, leggili prima; scrivi solo aggiornamenti concreti, mai placeholder vuoti. - Registra: decisioni, preferenze, vincoli, cicli aperti. - Evita segreti a meno che non venga richiesto esplicitamente. ## Strumenti e Skills - Gli strumenti vivono negli Skills; segui il `SKILL.md` di ogni Skill quando ti serve. - Mantieni le note specifiche dell'ambiente in `TOOLS.md` (note per gli Skills). ## Suggerimento di backup (consigliato) Se tratti questo workspace come la "memoria" di Clawd, rendilo un repo git (idealmente privato) così `AGENTS.md` e i tuoi file di memoria saranno sottoposti a backup. ```bash cd ~/.openclaw/workspace git init git add AGENTS.md git commit -m "Add Clawd workspace" # Optional: add a private remote + push ``` ## Cosa fa OpenClaw - Esegue Gateway WhatsApp + agente OpenClaw incorporato così l'assistente può leggere/scrivere chat, recuperare contesto ed eseguire Skills tramite il Mac host. - L'app macOS gestisce le autorizzazioni (registrazione schermo, notifiche, microfono) ed espone la CLI `openclaw` tramite il proprio binario incluso. - Le chat dirette confluiscono per impostazione predefinita nella sessione `main` dell'agente; i gruppi restano isolati come `agent:::group:` (stanze/canali: `agent:::channel:`); gli Heartbeat mantengono vive le attività in background. ## Skills principali (abilita in Settings → Skills) - **mcporter** - Runtime/CLI del server di strumenti per gestire backend esterni di Skills. - **Peekaboo** - Screenshot macOS rapidi con analisi di visione AI facoltativa. - **camsnap** - Acquisisci fotogrammi, clip o avvisi di movimento da telecamere di sicurezza RTSP/ONVIF. - **oracle** - CLI agente pronta per OpenAI con replay della sessione e controllo del browser. - **eightctl** - Controlla il tuo sonno dal terminale. - **imsg** - Invia, leggi e trasmetti iMessage e SMS. - **wacli** - CLI WhatsApp: sincronizza, cerca, invia. - **discord** - Azioni Discord: reazioni, sticker, sondaggi. Usa target `user:` o `channel:` (gli ID numerici senza prefisso sono ambigui). - **gog** - CLI Google Suite: Gmail, Calendar, Drive, Contacts. - **spotify-player** - Client Spotify da terminale per cercare/mettere in coda/controllare la riproduzione. - **sag** - Sintesi vocale ElevenLabs con UX say in stile mac; per impostazione predefinita trasmette agli altoparlanti. - **Sonos CLI** - Controlla gli altoparlanti Sonos (scoperta/stato/riproduzione/volume/raggruppamento) dagli script. - **blucli** - Riproduci, raggruppa e automatizza i player BluOS dagli script. - **OpenHue CLI** - Controllo dell'illuminazione Philips Hue per scene e automazioni. - **OpenAI Whisper** - Speech-to-text locale per dettatura rapida e trascrizioni della segreteria telefonica. - **Gemini CLI** - Modelli Google Gemini dal terminale per Q&A rapidi. - **agent-tools** - Toolkit di utilità per automazioni e script di supporto. ## Note d'uso - Preferisci la CLI `openclaw` per gli script; l'app Mac gestisce le autorizzazioni. - Esegui le installazioni dalla scheda Skills; nasconde il pulsante se è già presente un binario. - Mantieni gli Heartbeat abilitati così l'assistente può pianificare promemoria, monitorare inbox e attivare acquisizioni dalla fotocamera. - La UI Canvas viene eseguita a schermo intero con overlay nativi. Evita di posizionare controlli critici negli angoli in alto a sinistra/in alto a destra o sui bordi inferiori; aggiungi gutter espliciti nel layout e non fare affidamento sugli inset safe-area. - Per la verifica guidata da browser, usa `openclaw browser` (tabs/status/screenshot) con il profilo Chrome gestito da OpenClaw. - Per l'ispezione del DOM, usa `openclaw browser eval|query|dom|snapshot` (e `--json`/`--out` quando ti serve output leggibile dalla macchina). - Per le interazioni, usa `openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run` (click/type richiedono riferimenti snapshot; usa `evaluate` per i selettori CSS). ## Correlati - [Workspace dell'agente](/it/concepts/agent-workspace) - [Runtime dell'agente](/it/concepts/agent)