Sicurezza

Usare OpenClaw in modo sicuro

OpenClaw ha accesso al tuo computer, browser, file e servizi collegati. Questo lo rende potente — ma richiede configurarlo con disciplina. Questa guida ti spiega come.

⚠️

Questa è una guida pratica della community, non consulenza professionale di sicurezza. Consulta sempre la documentazione ufficiale sulla sicurezza e valuta i rischi per il tuo contesto specifico.

🏛️

Capire il modello di trust

La cosa più importante da capire: OpenClaw è un assistente personale, non un servizio multi-utente.

✅ Scenario supportato

Un utente → un Gateway → i tuoi agenti. Tu sei l'unico operatore fidato.

❌ Scenario NON supportato

Più utenti non fidati che condividono un singolo Gateway con accesso agli stessi strumenti.

Regola base: chiunque può mandare messaggi al tuo bot può potenzialmente usare i suoi strumenti. Quindi limita chi può parlarci.

🚪

Chi può parlare al tuo bot

La prima linea di difesa: controllare chi ha accesso.

🔒

Pairing (consigliato)

Solo i dispositivi accoppiati possono chattare. Il bot ignora tutti gli altri. Modalità: dmPolicy: "pairing"

📋

Allowlist

Lista esplicita di numeri/utenti autorizzati. allowFrom: ["+39..."]

👥

Gruppi con menzione

Nei gruppi, rispondi solo quando menzionato. requireMention: true

🔑

Token di autenticazione

Proteggi l'API del Gateway con un token lungo e casuale.

// ~/.openclaw/openclaw.json — esempio sicuro
{
  "gateway": {
    "mode": "local",
    "bind": "loopback",
    "auth": { "mode": "token", "token": "un-token-lungo-e-casuale" }
  },
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

🛡️

Permessi degli strumenti

OpenClaw ha diversi "gruppi di strumenti" che puoi abilitare o disabilitare:

Strumento Cosa fa Rischio

messaging Risposte chat, reazioni, invio messaggi 🟢 Basso

fs (file system) Leggere e scrivere file 🟡 Medio

browser Navigare web, cliccare, compilare form 🟡 Medio

exec (terminale) Eseguire comandi shell 🔴 Alto

elevated Comandi con sudo/admin 🔴 Alto

automation Cron, heartbeat, webhook 🟡 Medio

La regola d'oro: minimo privilegio

Dai all'agente solo i permessi che servono. Parti dal profilo più restrittivo e allarga man mano.

// Profilo base — solo messaggistica
{
  "tools": {
    "profile": "messaging",
    "exec": { "security": "deny", "ask": "always" },
    "elevated": { "enabled": false },
    "fs": { "workspaceOnly": true }
  }
}

Sistema di approvazione

Per le azioni sensibili, OpenClaw ha un sistema di approvazione: l'agente chiede il permesso prima di eseguire. Puoi impostarlo su:

🚫 deny

Vietato. Il comando non viene mai eseguito.

🙋 ask

Chiede conferma ogni volta. Tu approvi o rifiuti.

✅ allowlist

Comandi pre-approvati. Tutto il resto viene bloccato o chiesto.

🌐

Sicurezza di rete

🏠

Loopback only (default)

Il Gateway ascolta solo su localhost (127.0.0.1). Nessuno dall'esterno può raggiungerlo direttamente.

🔗

Accesso remoto

Se devi accederci da remoto, usa Tailscale (VPN mesh) o SSH tunnel. Mai esporre il Gateway su internet senza autenticazione.

🚨

Mai impostare bind: "0.0.0.0" senza un token di autenticazione forte. Chiunque potrebbe connettersi e usare il tuo agente.

🔐

Dati sensibili e segreti

Cosa NON mettere nella memoria dell'agente

🚫 Password e codici OTP

🚫 Numeri di carta di credito

🚫 Documenti d'identità

🚫 Token API in chiaro nei file di memoria

🚫 Informazioni personali non necessarie

Come gestire i segreti

🗝️ Secret Manager

OpenClaw ha un sistema di segreti integrato con openclaw secrets. Supporta 64+ target.

📁 Variabili d'ambiente

Usa file .env (non versionati) o variabili di sistema per API key e credenziali.

✨

Best practice — checklist

☐

Computer dedicato — separa l'agente dal tuo PC principale se puoi

☐

Token Gateway — lungo, casuale, unico

☐

Pairing attivo — solo i tuoi dispositivi possono chattare col bot

☐

Exec in ask mode — l'agente chiede prima di eseguire comandi

☐

File workspace-only — l'agente non scrive fuori dalla sua cartella

☐

Niente segreti in chiaro — usa .env o secret manager

☐

Security audit periodico — openclaw security audit

☐

Aggiornamenti — tieni OpenClaw aggiornato all'ultima versione

🔍

Security Audit automatico

OpenClaw ha un audit di sicurezza integrato. Eseguilo regolarmente:

# Audit base
openclaw security audit

# Audit approfondito
openclaw security audit --deep

# Fix automatico dei problemi trovati
openclaw security audit --fix

Controlla: accesso DM, policy dei gruppi, esposizione di rete, permessi file, strumenti abilitati, plugin e configurazioni potenzialmente pericolose.

⛔

Azioni irreversibili: bozza → revisione → invio

Per azioni che non puoi annullare, la regola è sempre: prima la bozza, poi la revisione, poi l'esecuzione.

📧 Email

Bozza → revisione → invio

📱 Post social

Bozza → approvazione → pubblicazione

🗑️ Cancellazioni

Conferma esplicita prima di eliminare

💳 Acquisti

Mai automatizzare pagamenti senza conferma

📤 File condivisi

Verifica prima di inviare a terzi

⚙️ Config di sistema

Review prima di modificare configurazioni

Pronto a partire in sicurezza?

Ora che sai come proteggerti, vai alla guida di installazione.

🚀 Iniziare 📚 Risorse