Guida alla Configurazione delle Chiavi API

Scopri come ottenere e configurare le chiavi API da Anthropic e OpenAI

Panoramica

OpenClaw Facile richiede chiavi API per abilitare le funzionalità AI di OpenClaw. Puoi configurare chiavi da:

  • Anthropic - Per i modelli Claude (Claude 3.5 Sonnet, Claude 3 Opus, ecc.)
  • OpenAI - Per i modelli GPT (GPT-4, GPT-3.5, ecc.)

È necessaria almeno una chiave API configurata, ma puoi aggiungere entrambi i provider per offrire più scelta di modelli.

Ottenere le Chiavi API Anthropic

Passaggio 1: Crea un Account Anthropic

Visita console.anthropic.com e registrati per un account. Dovrai verificare la tua email e aggiungere le informazioni di fatturazione (Anthropic addebita per utilizzo di token).

Passaggio 2: Genera una Chiave API

  1. Dalla console Anthropic, vai su "API Keys" nella barra laterale sinistra
  2. Clicca "Create Key"
  3. Dai alla tua chiave un nome descrittivo (es. "OpenClaw Facile Production")
  4. Copia la chiave immediatamente - verrà mostrata solo una volta

Attenzione: Conserva la tua chiave API in modo sicuro. Non salvarla mai nel controllo versione e non condividerla pubblicamente.

Passaggio 3: Aggiungi al Pannello OpenClaw Facile

  1. Vai al tuo pannello OpenClaw Facile
  2. Trova la sezione "Chiavi API" o l'area "Impostazioni"
  3. Incolla la tua chiave API Anthropic nel campo "Chiave API Anthropic"
  4. Clicca "Salva" o "Aggiorna Chiavi"
  5. Se hai già un'istanza in esecuzione, riavviala perché le modifiche abbiano effetto

Ottenere le Chiavi API OpenAI

Passaggio 1: Crea un Account OpenAI

Visita platform.openai.com e registrati per un account. Dovrai aggiungere un metodo di pagamento per utilizzare l'API (OpenAI addebita per utilizzo di token).

Passaggio 2: Vai alle Chiavi API

Dal pannello della piattaforma OpenAI, clicca sull'icona del profilo in alto a destra, poi seleziona "View API Keys" o vai direttamente alla sezione chiavi API.

Passaggio 3: Genera e Copia la Chiave

  1. Clicca "Create new secret key"
  2. Dai alla tua chiave un nome (es. "OpenClaw Facile")
  3. Copia la chiave immediatamente - verrà mostrata solo una volta
  4. Conservala in modo sicuro

Passaggio 4: Aggiungi al Pannello OpenClaw Facile

  1. Vai al tuo pannello OpenClaw Facile
  2. Trova la sezione "Chiavi API" o l'area "Impostazioni"
  3. Incolla la tua chiave API OpenAI nel campo "Chiave API OpenAI"
  4. Clicca "Salva" o "Aggiorna Chiavi"
  5. Se hai già un'istanza in esecuzione, riavviala perché le modifiche abbiano effetto

Best Practice di Sicurezza

  • Crittografia a riposo - OpenClaw Facile crittografa le tue chiavi API nel nostro database utilizzando crittografia standard di settore
  • Accesso isolato - Le tue chiavi API sono accessibili solo alla tua istanza, mai ad altri utenti o istanze
  • Non condividere mai le chiavi - Tratta le chiavi API come password. Non condividerle via email, chat o canali pubblici
  • Ruota regolarmente - Consigliamo di ruotare le chiavi API ogni 90 giorni
  • Monitora l'utilizzo - Controlla regolarmente i pannelli Anthropic/OpenAI per utilizzi imprevisti
  • Niente controllo versione - Non salvare mai le chiavi API su Git, GitHub o qualsiasi sistema di controllo versione

Se ritieni che la tua chiave API sia stata compromessa, revocala immediatamente nella console del tuo provider (Anthropic o OpenAI) e generane una nuova.

Selezione Modello

Se la selezione del modello è abilitata, puoi scegliere quale modello AI utilizza la tua istanza dalla pagina Modelli AI nel tuo pannello. Il modello selezionato viene configurato automaticamente nella tua istanza.

Cambiare modello richiede un abbonamento attivo. Il modello che selezioni determina quale chiave API è necessaria — chiavi Anthropic per i modelli Claude, chiavi OpenAI per i modelli GPT.

Aggiornamento Chiavi API

Puoi aggiornare le tue chiavi API in qualsiasi momento dal pannello OpenClaw Facile:

  1. Vai al tuo pannello
  2. Vai alla sezione Impostazioni o Chiavi API
  3. Aggiorna i campi delle chiavi con le tue nuove chiavi API
  4. Clicca "Salva" o "Aggiorna Chiavi"
  5. Riavvia la tua istanza perché le modifiche abbiano effetto

Non è necessario reinstallare la tua istanza per aggiornare le chiavi API. Salvando le nuove chiavi, la tua macchina in esecuzione verrà automaticamente aggiornata con la nuova configurazione.

Risoluzione Problemi

Errore "Chiave API non valida"

  • Controlla eventuali spazi o caratteri extra quando copi la chiave
  • Verifica che la chiave non sia stata revocata nella console del tuo provider
  • Assicurati che il tuo account del provider abbia la fatturazione configurata e crediti sufficienti
  • Prova a generare una nuova chiave e aggiornarla in OpenClaw Facile
  • Riavvia la tua istanza dopo aver aggiornato le chiavi

Modelli non visibili in OpenClaw

  • Conferma che la chiave API corrispondente sia configurata (Anthropic per Claude, OpenAI per GPT)
  • Riavvia la tua istanza dopo aver aggiunto nuove chiavi
  • Verifica che la chiave API abbia accesso ai modelli che ti aspetti

Hai bisogno di ulteriore aiuto?

Contatta il nostro team di supporto se riscontri ancora problemi con la configurazione delle chiavi API.