Configurazione dell'assistente personale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

⚠️ Prima la sicurezza

• eseguire comandi sulla tua macchina (a seconda della tua policy sugli strumenti)
• leggere/scrivere file nel tuo workspace
• inviare messaggi verso l’esterno tramite WhatsApp/Telegram/Discord/Mattermost e altri canali inclusi

• Imposta sempre channels.whatsapp.allowFrom (non eseguirlo mai aperto a tutto il mondo sul tuo Mac personale).
• Usa un numero WhatsApp dedicato per l’assistente.
• Gli Heartbeat ora sono predefiniti ogni 30 minuti. Disabilitali finché non ti fidi della configurazione impostando agents.defaults.heartbeat.every: "0m".

​

Prerequisiti

• OpenClaw installato e configurato con onboarding: consulta Per iniziare se non l’hai ancora fatto
• Un secondo numero di telefono (SIM/eSIM/prepagata) per l’assistente

​

Configurazione con due telefoni (consigliata)

​

Avvio rapido in 5 minuti

1. Associa WhatsApp Web (mostra il QR; scansionalo con il telefono dell’assistente):

openclaw channels login

2. Avvia il Gateway (lascialo in esecuzione):

openclaw gateway --port 18789

3. Inserisci una configurazione minima in ~/.openclaw/openclaw.json:

{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

Dare all’agente un workspace (AGENTS)

openclaw setup

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}

{
  agents: {
    defaults: {
      skipBootstrap: true,
    },
  },
}

​

La configurazione che lo trasforma in “un assistente”

• persona/istruzioni in SOUL.md
• impostazioni predefinite di ragionamento (se desiderato)
• Heartbeat (una volta che ti fidi)

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      workspace: "~/.openclaw/workspace",
      thinkingDefault: "high",
      timeoutSeconds: 1800,
      // Start with 0; enable later.
      heartbeat: { every: "0m" },
    },
    list: [
      {
        id: "main",
        default: true,
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

​

Sessioni e memoria

• File di sessione: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
• Metadati di sessione (uso dei token, ultimo instradamento, ecc.): ~/.openclaw/agents/<agentId>/sessions/sessions.json (legacy: ~/.openclaw/sessions/sessions.json)
• /new o /reset avvia una nuova sessione per quella chat (configurabile tramite resetTriggers). Se inviato da solo, OpenClaw conferma il reset senza invocare il modello.
• /compact [instructions] compatta il contesto della sessione e segnala il budget di contesto rimanente.

​

Heartbeat (modalità proattiva)

• Se HEARTBEAT.md esiste ma è di fatto vuoto (solo righe vuote e intestazioni markdown come # Heading), OpenClaw salta l’esecuzione dell’Heartbeat per risparmiare chiamate API.
• Se il file manca, l’Heartbeat viene comunque eseguito e il modello decide cosa fare.
• Se l’agente risponde con HEARTBEAT_OK (facoltativamente con un breve padding; vedi agents.defaults.heartbeat.ackMaxChars), OpenClaw sopprime la consegna in uscita per quell’Heartbeat.
• Per impostazione predefinita, la consegna dell’Heartbeat a destinazioni DM-style user:<id> è consentita. Imposta agents.defaults.heartbeat.directPolicy: "block" per sopprimere la consegna a destinazioni dirette mantenendo attive le esecuzioni dell’Heartbeat.
• Gli Heartbeat eseguono turni completi dell’agente: intervalli più brevi consumano più token.

{
  agents: {
    defaults: {
      heartbeat: { every: "30m" },
    },
  },
}

​

Media in entrata e in uscita

• {{MediaPath}} (percorso del file temporaneo locale)
• {{MediaUrl}} (pseudo-URL)
• {{Transcript}} (se la trascrizione audio è abilitata)

Here's the screenshot.
MEDIA:https://example.com/screenshot.png

• Se tools.fs.workspaceOnly è true, i percorsi locali MEDIA: in uscita restano limitati alla root temporanea di OpenClaw, alla cache dei media, ai percorsi del workspace dell’agente e ai file generati dalla sandbox.
• Se tools.fs.workspaceOnly è false, MEDIA: in uscita può usare file locali dell’host che l’agente è già autorizzato a leggere.
• I percorsi locali possono essere assoluti, relativi al workspace o relativi alla home con ~/.
• Gli invii locali dall’host consentono comunque solo media e tipi di documenti sicuri (immagini, audio, video, PDF e documenti Office). Testo semplice e file simili a segreti non vengono trattati come media inviabili.

​

Checklist operativa

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # asks the gateway for a live health probe with channel probes when supported
openclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

​

Passaggi successivi

• WebChat: WebChat
• Operazioni Gateway: Runbook Gateway
• Cron + risvegli: Job Cron
• Companion della barra dei menu macOS: App OpenClaw per macOS
• App nodo iOS: App iOS
• App nodo Android: App Android
• Stato Windows: Windows (WSL2)
• Stato Linux: App Linux
• Sicurezza: Sicurezza

​

Correlati

• Per iniziare
• Configurazione
• Panoramica dei canali