AGENTS.md predefinito

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à):

mkdir -p ~/.openclaw/workspace

2. Copia i template predefiniti del workspace nel workspace:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.mdcp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.mdcp 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:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. Facoltativo: scegli un workspace diverso impostando agents.defaults.workspace (supporta ~):

{  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.

cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit 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:<agentId>:<channel>:group:<id> (stanze/canali: agent:<agentId>:<channel>:channel:<id>); 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:<id> o channel:<id> (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
• Runtime dell'agente