Modifica Configurazione OpenClaw: Guida Completa all'Installazione (2026)

Q: Dove viene memorizzato il file di configurazione di OpenClaw?

La posizione predefinita è ~/.openclaw/config.yaml. In alcune installazioni potrebbe trovarsi in ~/.config/openclaw/config.yaml. Esegui openclaw config show --path per vedere la posizione esatta.

Q: Come aggiorno OpenClaw?

```bash pip install --upgrade openclaw

Q: Come ripristino la mia configurazione ai valori predefiniti?

```bash openclaw config reset ```

TL;DR

Riferimento rapido per i comandi di configurazione OpenClaw più comuni:

bash

# Apri l'editor di configurazione
openclaw config edit

# Imposta un valore specifico
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Visualizza la configurazione corrente
openclaw config show

# Convalida e risolvi i problemi di configurazione
openclaw doctor
openclaw doctor --fix

# Ripristina i valori predefiniti
openclaw config reset

Cos'è OpenClaw?

OpenClaw è un framework per assistenti IA open source che connette modelli linguistici di grandi dimensioni a canali di messaggistica come WhatsApp, Discord, Telegram e Slack. Supporta molteplici provider di modelli — OpenAI, Anthropic, Ollama (modelli locali), Google e altri — e può essere esteso con skill e plugin personalizzati.

Il cuore di OpenClaw è il suo sistema di configurazione. Quasi tutto — quali canali sono attivi, quale modello usare, quali skill sono caricate — è controllato tramite file di configurazione. Padroneggiare openclaw config edit è la chiave per far funzionare OpenClaw esattamente come desideri.

openclaw config edit: Le Basi

Apertura dell'Editor di Configurazione

Il comando principale per configurare OpenClaw è:

bash

openclaw config edit

Questo apre il tuo file di configurazione nel tuo editor di terminale predefinito (solitamente nano, vim, o qualunque sia impostato in $EDITOR). Il file di configurazione si trova tipicamente in ~/.openclaw/config.yaml o ~/.config/openclaw/config.yaml a seconda dell'installazione.

Struttura del File di Configurazione

Il file di configurazione di OpenClaw è in formato YAML e organizzato in sezioni:

yaml

# Configurazione del modello
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # stringa identificativa del modello
  temperature: 0.7
  max_tokens: 4096

# Configurazione dei canali
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# Skill e plugin
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# Prompt di sistema
system_prompt: "You are a helpful assistant."

Impostazione di Valori Singoli

Invece di modificare l'intero file, puoi impostare singoli valori di configurazione dalla riga di comando:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

Questo è utile per lo scripting o per modifiche rapide senza aprire un editor.

Configurazione dei Canali

L'integrazione di WhatsApp richiede un account Meta Business e l'accesso alle API di WhatsApp Business.

bash

# Abilita il canale WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

Problema comune: WhatsApp richiede un URL webhook. È necessario esporre OpenClaw su internet utilizzando un reverse proxy (nginx, Caddy) o un servizio di tunnel (ngrok, Cloudflare Tunnel).

bash

# Imposta l'URL del webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

La configurazione di Discord è più semplice — ti serve solo un bot token dal Discord Developer Portal.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

Suggerimento: Assicurati che il tuo bot Discord abbia l'intento privilegiato "Message Content" abilitato nel Developer Portal, altrimenti non sarà in grado di leggere i messaggi.

Telegram richiede un bot token da @BotFather:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram supporta sia la modalità polling che quella webhook. Il polling è più semplice per lo sviluppo (non è richiesto un URL pubblico):

bash

openclaw config set channels.telegram.mode polling

Per la produzione, usa la modalità webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

L'integrazione di Slack utilizza la Socket Mode (consigliata) o l'API Events:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

La Socket Mode è consigliata perché non richiede un URL pubblico.

Configurazione dei Provider di Modelli

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

Imposta la tua chiave API come variabile d'ambiente (non inserirla nel file di configurazione):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (Modelli Locali)

Qui è dove OpenClaw eccelle per gli utenti attenti alla privacy. Ollama ti permette di eseguire modelli localmente senza chiavi API o dati che lasciano la tua macchina.

bash

# Installa prima Ollama
# https://ollama.ai

# Scarica un modello
ollama pull llama3.3

# Configura OpenClaw per usare Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Problema comune: Se OpenClaw non riesce a connettersi a Ollama, assicurati che Ollama sia in esecuzione (ollama serve) e che l'URL di base corrisponda. La porta predefinita di Ollama è 11434.

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI utilizza un'API compatibile con OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # Usa la chiave xAI con il provider OpenAI

Errori di Configurazione Comuni e Soluzioni

Errore: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

Questo solitamente significa che c'è un errore di battitura nella chiave di configurazione. Controlla l'ortografia. Errori comuni:

chanels → channels

providr → provider

telgram → telegram

Esegui openclaw config show per vedere tutte le chiavi valide.

Errore: "Channel auto-enabled without credentials"

Alcune versioni di OpenClaw abilitano automaticamente i canali quando si impostano le credenziali, anche se non sono stati esplicitamente abilitati. Ciò può causare errori all'avvio se le credenziali sono incomplete.

Soluzione:

bash

# Disabilita esplicitamente i canali che non stai utilizzando
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Errore: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

È necessario impostare la variabile d'ambiente corrispondente. OpenClaw intenzionalmente non memorizza le chiavi API nel file di configurazione per motivi di sicurezza.

Soluzione: Aggiungi la chiave API al tuo profilo della shell (~/.bashrc, ~/.zshrc) o usa un file .env:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Utilizzo di openclaw doctor

Il comando openclaw doctor convalida l'intera configurazione e segnala eventuali problemi:

bash

openclaw doctor

Esempio di output:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

Il flag --fix tenta di risolvere i problemi automaticamente:

bash

openclaw doctor --fix

Questo disabiliterà i canali con credenziali mancanti, correggerà problemi di formattazione noti e suggerirà soluzioni manuali per i problemi che non può risolvere automaticamente.

Configurazione Avanzata

Skill Personalizzate

OpenClaw supporta skill personalizzate (plugin) che estendono le capacità dell'assistente:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

O tramite riga di comando:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

Configurazione Speech-to-Text (STT)

Per il supporto dei messaggi vocali su WhatsApp e Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # rilevamento automatico o specifica "it", "en", "es", ecc.

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Integrazione Smart Home Tuya

OpenClaw può controllare dispositivi smart home compatibili con Tuya:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

Questo ti permette di controllare luci, interruttori, termostati e altri dispositivi Tuya attraverso comandi in linguaggio naturale in qualsiasi canale connesso.

Configurazioni di Modelli Multipli

Puoi definire preset di modelli e passare dall'uno all'altro:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# o cambia a runtime
openclaw --model fast

Domande Frequenti

Dove viene memorizzato il file di configurazione di OpenClaw?

La posizione predefinita è ~/.openclaw/config.yaml. In alcune installazioni potrebbe trovarsi in ~/.config/openclaw/config.yaml. Esegui openclaw config show --path per vedere la posizione esatta.

Posso usare OpenClaw senza alcuna API cloud?

Sì. Configura Ollama come provider del modello e usa Telegram in modalità polling. Questo ti darà un assistente IA completamente locale e privato, senza che alcun dato lasci la tua macchina.

Come aggiorno OpenClaw?

bash

pip install --upgrade openclaw
# o
npm update -g openclaw

Dopo l'aggiornamento, esegui openclaw doctor per verificare eventuali cambiamenti nel formato della configurazione.

Posso eseguire più canali contemporaneamente?

Sì. Abilita tutti i canali che desideri — OpenClaw li gestisce contemporaneamente. Ogni canale condivide la stessa configurazione di modello e skill.

Come ripristino la mia configurazione ai valori predefiniti?

bash

openclaw config reset

Questo sovrascrive il tuo file di configurazione con il template predefinito. Esegui prima un backup della tua configurazione esistente, se necessario.

Vuoi Qualcosa di Più Semplice?

OpenClaw è potente ma richiede dimestichezza con il terminale e configurazione manuale. Se vuoi creare e lanciare prodotti basati sull'IA senza gestire file di configurazione, provider di modelli e integrazioni di canali:

Y Build gestisce l'intero stack — deployment, video di prodotto, SEO IA e analytics. Niente file di configurazione. Niente terminale. Solo creazione e lancio. Inizia gratis →

Fonti:

TL;DR

Riferimento rapido per i comandi di configurazione OpenClaw più comuni:

bash

# Apri l'editor di configurazione
openclaw config edit

# Imposta un valore specifico
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Visualizza la configurazione corrente
openclaw config show

# Convalida e risolvi i problemi di configurazione
openclaw doctor
openclaw doctor --fix

# Ripristina i valori predefiniti
openclaw config reset

Cos'è OpenClaw?

openclaw config edit: Le Basi

Apertura dell'Editor di Configurazione

Il comando principale per configurare OpenClaw è:

bash

openclaw config edit

Struttura del File di Configurazione

Il file di configurazione di OpenClaw è in formato YAML e organizzato in sezioni:

yaml

# Configurazione del modello
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # stringa identificativa del modello
  temperature: 0.7
  max_tokens: 4096

# Configurazione dei canali
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# Skill e plugin
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# Prompt di sistema
system_prompt: "You are a helpful assistant."

Impostazione di Valori Singoli

Invece di modificare l'intero file, puoi impostare singoli valori di configurazione dalla riga di comando:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

Questo è utile per lo scripting o per modifiche rapide senza aprire un editor.

Configurazione dei Canali

L'integrazione di WhatsApp richiede un account Meta Business e l'accesso alle API di WhatsApp Business.

bash

# Abilita il canale WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

Problema comune: WhatsApp richiede un URL webhook. È necessario esporre OpenClaw su internet utilizzando un reverse proxy (nginx, Caddy) o un servizio di tunnel (ngrok, Cloudflare Tunnel).

bash

# Imposta l'URL del webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

La configurazione di Discord è più semplice — ti serve solo un bot token dal Discord Developer Portal.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

Suggerimento: Assicurati che il tuo bot Discord abbia l'intento privilegiato "Message Content" abilitato nel Developer Portal, altrimenti non sarà in grado di leggere i messaggi.

Telegram richiede un bot token da @BotFather:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram supporta sia la modalità polling che quella webhook. Il polling è più semplice per lo sviluppo (non è richiesto un URL pubblico):

bash

openclaw config set channels.telegram.mode polling

Per la produzione, usa la modalità webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

L'integrazione di Slack utilizza la Socket Mode (consigliata) o l'API Events:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

La Socket Mode è consigliata perché non richiede un URL pubblico.

Configurazione dei Provider di Modelli

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

Imposta la tua chiave API come variabile d'ambiente (non inserirla nel file di configurazione):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (Modelli Locali)

Qui è dove OpenClaw eccelle per gli utenti attenti alla privacy. Ollama ti permette di eseguire modelli localmente senza chiavi API o dati che lasciano la tua macchina.

bash

# Installa prima Ollama
# https://ollama.ai

# Scarica un modello
ollama pull llama3.3

# Configura OpenClaw per usare Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Problema comune: Se OpenClaw non riesce a connettersi a Ollama, assicurati che Ollama sia in esecuzione (ollama serve) e che l'URL di base corrisponda. La porta predefinita di Ollama è 11434.

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI utilizza un'API compatibile con OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # Usa la chiave xAI con il provider OpenAI

Errori di Configurazione Comuni e Soluzioni

Errore: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

Questo solitamente significa che c'è un errore di battitura nella chiave di configurazione. Controlla l'ortografia. Errori comuni:

chanels → channels

providr → provider

telgram → telegram

Esegui openclaw config show per vedere tutte le chiavi valide.

Errore: "Channel auto-enabled without credentials"

Soluzione:

bash

# Disabilita esplicitamente i canali che non stai utilizzando
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Errore: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

È necessario impostare la variabile d'ambiente corrispondente. OpenClaw intenzionalmente non memorizza le chiavi API nel file di configurazione per motivi di sicurezza.

Soluzione: Aggiungi la chiave API al tuo profilo della shell (~/.bashrc, ~/.zshrc) o usa un file .env:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Utilizzo di openclaw doctor

Il comando openclaw doctor convalida l'intera configurazione e segnala eventuali problemi:

bash

openclaw doctor

Esempio di output:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

Il flag --fix tenta di risolvere i problemi automaticamente:

bash

openclaw doctor --fix

Questo disabiliterà i canali con credenziali mancanti, correggerà problemi di formattazione noti e suggerirà soluzioni manuali per i problemi che non può risolvere automaticamente.

Configurazione Avanzata

Skill Personalizzate

OpenClaw supporta skill personalizzate (plugin) che estendono le capacità dell'assistente:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

O tramite riga di comando:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

Configurazione Speech-to-Text (STT)

Per il supporto dei messaggi vocali su WhatsApp e Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # rilevamento automatico o specifica "it", "en", "es", ecc.

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Integrazione Smart Home Tuya

OpenClaw può controllare dispositivi smart home compatibili con Tuya:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

Questo ti permette di controllare luci, interruttori, termostati e altri dispositivi Tuya attraverso comandi in linguaggio naturale in qualsiasi canale connesso.

Configurazioni di Modelli Multipli

Puoi definire preset di modelli e passare dall'uno all'altro:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# o cambia a runtime
openclaw --model fast

Domande Frequenti

Dove viene memorizzato il file di configurazione di OpenClaw?

Posso usare OpenClaw senza alcuna API cloud?

Sì. Configura Ollama come provider del modello e usa Telegram in modalità polling. Questo ti darà un assistente IA completamente locale e privato, senza che alcun dato lasci la tua macchina.

Come aggiorno OpenClaw?

bash

pip install --upgrade openclaw
# o
npm update -g openclaw

Dopo l'aggiornamento, esegui openclaw doctor per verificare eventuali cambiamenti nel formato della configurazione.

Posso eseguire più canali contemporaneamente?

Sì. Abilita tutti i canali che desideri — OpenClaw li gestisce contemporaneamente. Ogni canale condivide la stessa configurazione di modello e skill.

Come ripristino la mia configurazione ai valori predefiniti?

bash

openclaw config reset

Questo sovrascrive il tuo file di configurazione con il template predefinito. Esegui prima un backup della tua configurazione esistente, se necessario.

Vuoi Qualcosa di Più Semplice?

Y Build gestisce l'intero stack — deployment, video di prodotto, SEO IA e analytics. Niente file di configurazione. Niente terminale. Solo creazione e lancio. Inizia gratis →

Fonti: