Source: https://aiprimetech.io/it/learn/run-openclaw-with-claude-api/

[Home](/it/) / [Impara](/it/learn/) / Eseguire OpenClaw senza limiti su Claude 

# Eseguire OpenClaw senza limiti con Claude 

OpenClaw è un gateway IA multicanale che collega Claude a oltre 50 canali di messaggistica attraverso un'architettura hub-and-spoke. Ogni canale è un endpoint di inferenza indipendente: bot Telegram, server Discord, spazi di lavoro Slack, widget web e integrazioni personalizzate passano tutti attraverso un gateway centrale in esecuzione sulla tua infrastruttura. Con le skill inserite nei prompt di sistema e canali che non si chiudono mai, OpenClaw comporta un consumo continuo e costante di API che cresce linearmente con il numero di canali e utenti attivi. 

## L'architettura sempre attiva di OpenClaw 

OpenClaw opera come gateway hub-and-spoke. L'hub è un processo centrale, in genere in esecuzione su un VPS sulla porta 18789, che gestisce la configurazione dei modelli, l'inserimento delle skill e l'instradamento delle richieste. Gli spoke sono connettori di canale: ciascuno mantiene una connessione persistente a una piattaforma di messaggistica e inoltra i messaggi in arrivo all'hub per l'inferenza. 

Ogni canale è un rubinetto di inferenza aperto. Quando un utente invia un messaggio su qualsiasi piattaforma collegata, il connettore del canale lo inoltra all'hub, che costruisce il prompt completo (prompt di sistema + skill + cronologia della conversazione + messaggio dell'utente), lo invia a Claude e trasmette la risposta in streaming al canale. Non ci sono code né elaborazione in batch: ogni messaggio viene sottoposto immediatamente a inferenza. 

Il gateway non dorme mai. Finché il processo è in esecuzione, tutti gli oltre 50 canali sono attivi e qualsiasi messaggio in arrivo attiva una chiamata all'API di Claude. A differenza degli strumenti interattivi, che consumano token solo quando uno sviluppatore sta lavorando, OpenClaw consuma token ogni volta che un utente invia un messaggio su qualsiasi canale: nelle installazioni attive, questo significa centinaia o migliaia di chiamate al giorno. Ciò rende l'accesso illimitato non solo comodo, ma economicamente necessario per le installazioni destinate a un uso intensivo. 

## Configurazione del provider in openclaw.json 

La configurazione dei modelli di OpenClaw si trova in ~/.openclaw/openclaw.json, nel blocco models.providers. Ogni voce di provider richiede un nome, il campo api (per Claude MUST essere impostato esplicitamente su 'anthropic-messages': non è il valore predefinito), baseUrl che punta al tuo gateway e apiKey per l'autenticazione. Il campo api controlla il formato delle richieste usato da OpenClaw. 

Imposta baseUrl su https://aiprimetech.io (host radice, senza /v1: il gestore anthropic-messages aggiunge il percorso corretto). Per apiKey puoi usare valori diretti o l'interpolazione di variabili d'ambiente con la sintassi ${ENV_VAR}. L'interpolazione è utile per mantenere i segreti fuori dal file di configurazione: imposta apiKey su '${UNLIMITED_API_KEY}' ed esporta la variabile nella shell o nell'unità systemd. 

Puoi anche specificare header personalizzati nella configurazione del provider. Usa il campo headers per passare flag anthropic-beta o header di instradamento personalizzati. Ad esempio, headers: {'anthropic-beta': 'max-tokens-3-5-sonnet-2024-07-15'} abilita un output esteso per i modelli supportati. Sul gateway illimitato, gli header standard funzionano senza modifiche. 

## Voci dei modelli e obbligo del campo api 

Un'insidia cruciale nella configurazione di OpenClaw: il campo api in ogni voce di modello MUST essere impostato esplicitamente su 'anthropic-messages'. Se viene omesso, OpenClaw usa per impostazione predefinita un formato di completamento generico incompatibile con Claude. Questo provoca errori criptici che sembrano problemi di connessione, ma sono in realtà incompatibilità di formato. Includi sempre api: 'anthropic-messages' in ogni voce di modello Claude. 

Definisci le voci dei modelli in models.models in openclaw.json. Ogni voce fa riferimento a un provider tramite il nome e specifica l'ID del modello. Crea voci per ogni variante di Claude: claude-sonnet-4-5 come predefinito per la maggior parte dei canali, claude-opus-4-6 per i canali che richiedono un ragionamento più approfondito e claude-haiku-4-5 per i canali ad alto volume in cui la velocità conta più della profondità. 

Assegna i modelli ai canali nella configurazione dei canali. Ogni canale può usare un modello diverso: un canale di assistenza clienti potrebbe usare Sonnet per risposte equilibrate, un canale tecnico potrebbe usare Opus per spiegazioni complesse e un canale di notifiche potrebbe usare Haiku per conferme rapide. Con l'accesso illimitato, assegna i modelli in base alle esigenze di qualità senza considerazioni sui costi. 

## Gateway hub-and-spoke sulla porta 18789 

Il gateway OpenClaw viene generalmente eseguito sulla porta 18789, configurabile in openclaw.json tramite server.port. Espone un'API REST che i connettori dei canali usano per inviare messaggi e ricevere risposte. Il gateway gestisce internamente la costruzione dei prompt, la selezione dei modelli, la gestione della cronologia delle conversazioni e lo streaming delle risposte. 

Distribuisci il gateway su un VPS che garantisca una disponibilità affidabile: deve essere in esecuzione 24/7 affinché i canali continuino a rispondere. Usa systemd o Docker per garantire il riavvio automatico in caso di arresto anomalo. Il processo richiede poche risorse di CPU e memoria; il collo di bottiglia è sempre la latenza delle chiamate all'API a monte, piuttosto che l'elaborazione locale. Un VPS di piccole dimensioni (1 CPU, 1 GB di RAM) gestisce senza problemi decine di canali simultanei. 

Il gateway mantiene le cronologie delle conversazioni in memoria, con persistenza configurabile su disco o Redis. Ogni conversazione attiva su qualsiasi canale ha un proprio contesto che cresce nel tempo. Con 50 canali e più utenti attivi per canale, il gateway può mantenere centinaia di stati di conversazione simultanei. La gestione del contesto è automatica: le vecchie conversazioni vengono eliminate in base a impostazioni TTL configurabili. 

## Inserimento delle skill e gestione del prompt di sistema 

Il sistema di skill di OpenClaw inserisce nel prompt di sistema di ogni richiesta istruzioni specifiche per ciascuna capacità. Le skill sono definite come file di testo nella directory skills e possono essere assegnate a canali specifici o applicate globalmente. Ogni skill aggiunge un contesto che aiuta Claude a rispondere in modo appropriato allo scopo del canale: tono dell'assistenza clienti, stile della documentazione tecnica, conoscenze di un dominio specifico. 

Ogni skill aggiunge token a ogni richiesta su ogni canale a cui è assegnata. Un canale con cinque skill attive potrebbe aggiungere 2,000-5,000 token al prompt di sistema di ogni richiesta prima ancora di includere la cronologia della conversazione. Su cinquanta canali con diverse configurazioni delle skill, il carico aggiuntivo totale giornaliero dovuto alle skill è considerevole. Con l'accesso illimitato, questo non è un problema: scrivi skill complete senza preoccuparti del costo per richiesta. 

Le skill possono includere contenuti dinamici tramite variabili di modello. OpenClaw supporta l'inserimento di informazioni sull'utente, contesto del canale, ora del giorno e variabili personalizzate nel testo delle skill. Questo inserimento dinamico avviene al momento della richiesta, garantendo che le skill contengano sempre informazioni aggiornate. Tale flessibilità consente comportamenti sofisticati per ciascun canale senza una logica di instradamento complessa. 

## Configurazione dei canali e scalabilità 

Ogni canale in OpenClaw viene configurato nella sezione channels di openclaw.json o in file di configurazione dei canali separati. Una voce di canale specifica il tipo di piattaforma (telegram, discord, slack, web, custom), le credenziali di autenticazione per quella piattaforma, il modello da usare, le skill assegnate e le impostazioni di gestione delle conversazioni (lunghezza della cronologia, TTL, persona). 

La scalabilità è lineare: ogni nuovo canale aggiunge un ulteriore endpoint di inferenza aperto. Aggiungere un bot Telegram aggiunge un canale. Aggiungere un server Discord con più canali monitorati potrebbe aggiungerne dieci. Ogni canale Discord monitorato è un flusso di conversazione separato con un contesto indipendente. Una distribuzione OpenClaw di grandi dimensioni con Discord, Telegram, Slack e widget web può facilmente avere 50-100 endpoint di inferenza attivi. 

Con la fatturazione per token, aumentare i canali significa aumentare direttamente i costi. Ogni nuovo canale aggiunge una spesa API proporzionale al suo volume di messaggi. Con un piano illimitato, puoi aumentare liberamente i canali entro i limiti di frequenza previsti per l'uso corretto. Aggiungi nuove piattaforme, nuovi bot, nuovi widget: la tariffa fissa li copre tutti. L'unico vincolo è il limite di frequenza al minuto, sufficientemente ampio per la maggior parte delle distribuzioni multicanale. 

## Risoluzione dei problemi delle distribuzioni OpenClaw 

L'errore di configurazione più comune è dimenticare api: 'anthropic-messages' nelle voci dei modelli. Senza questo campo, OpenClaw invia richieste nel formato sbagliato e riceve errori incomprensibili dall'API. Se riscontri errori di analisi delle risposte o errori 400 imprevisti, controlla prima il campo api. Deve essere impostato esplicitamente: non esiste un valore predefinito corretto per i modelli Claude. 

Se alcuni canali non funzionano mentre altri funzionano, il problema è solitamente l'assegnazione del modello a livello di canale, che rimanda a una voce di modello inesistente o contenente un refuso. OpenClaw non convalida i riferimenti ai modelli all'avvio: l'errore si verifica al momento della richiesta, quando il canale tenta di usare il modello configurato in modo errato. Verifica che il riferimento al modello di ogni canale corrisponda esattamente al nome di una voce esistente in models.models. 

In caso di errori relativi ai limiti di frequenza sotto un carico multicanale elevato, ricorda che tutti i canali condividono la stessa chiave API e gli stessi limiti di frequenza. Se cinquanta canali sono attivi contemporaneamente nelle ore di punta, la frequenza complessiva delle richieste potrebbe superare i limiti di uso corretto. Il gateway gestisce le risposte 429 mettendo le richieste in coda e riprovandole: questo aumenta la latenza, ma non causa la perdita di messaggi. Per distribuzioni con volumi molto elevati, contatta AI Prime Tech per richiedere limiti di frequenza più alti. 

Copia

```
// ~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "unlimited": {
        "api": "anthropic-messages",
        "baseUrl": "https://aiprimetech.io",
        "apiKey": "${UNLIMITED_API_KEY}"
      }
    },
    "models": {
      "sonnet": { "provider": "unlimited", "model": "claude-sonnet-4-5" },
      "opus":   { "provider": "unlimited", "model": "claude-opus-4-6" },
      "haiku":  { "provider": "unlimited", "model": "claude-haiku-4-5" }
    }
  },
  "server": { "port": 18789 }
}

# IMPORTANT: api: "anthropic-messages" is REQUIRED
# Without it, OpenClaw uses wrong request format
```

## Domande frequenti 

 Perché devo impostare esplicitamente api su anthropic-messages?

OpenClaw non utilizza alcun formato API specifico come predefinito. Senza api: 'anthropic-messages', usa un formato generico di completamento incompatibile con l'API Messages di Claude. Questo causa errori nelle richieste che sembrano errori di connessione, ma sono in realtà incompatibilità di formato. Impostalo sempre esplicitamente per ogni voce di modello Claude. Quanti canali può gestire OpenClaw con un piano illimitato?

Non esiste un limite rigido al numero di canali imposto dal gateway. Il vincolo pratico è il limite di frequenza per l'uso corretto: tutti i canali condividono una sola chiave API. La maggior parte delle distribuzioni con 50-100 canali rimane ampiamente entro i limiti durante l'uso normale. Durante i picchi di traffico, il gateway mette in coda le richieste in eccesso e le riprova dopo il ripristino della finestra del limite di frequenza. Ogni canale mantiene una cronologia delle conversazioni separata?

Sì. Ogni canale e ogni utente all'interno di un canale ha un contesto di conversazione indipendente. Il gateway gestisce tutte le cronologie in memoria con un TTL configurabile. Una distribuzione con 50 canali e più utenti per canale mantiene centinaia di stati di conversazione simultanei. Posso usare l'interpolazione delle variabili d'ambiente per la chiave API?

Sì. Imposta apiKey su '${ENV_VAR_NAME}' in openclaw.json e OpenClaw ne risolve il valore dall'ambiente del processo all'avvio. Questo evita di inserire segreti nei file di configurazione, ed è utile per le distribuzioni Docker in cui i segreti vengono iniettati tramite variabili d'ambiente. Cosa succede se il processo del gateway si arresta in modo anomalo?

Tutti i canali si disconnettono e i messaggi vanno persi fino al riavvio. Usa systemd (Restart=always) o Docker (restart: unless-stopped) per garantire il ripristino automatico. Le cronologie delle conversazioni memorizzate solo in memoria vanno perse in caso di arresto anomalo: abilita la persistenza su disco o Redis per le distribuzioni importanti.  

Inizia a usare Claude in pochi minuti

Ottieni una chiave API: non servono un account Anthropic né una lista d'attesa.[Ottieni la tua chiave API](/register) 

AI Prime Tech è un gateway API indipendente. Non è affiliato ad Anthropic, non è approvato da Anthropic e non è un suo rivenditore. Claude e i nomi dei modelli correlati sono marchi dei rispettivi proprietari.    

## Altre guide all'API di Claude

[Come ottenere una chiave API Claude](/it/learn/how-to-get-a-claude-api-key/)[I prezzi dell'API Claude, spiegati](/it/learn/claude-api-pricing-explained/)[Il modo più economico per usare l'API Claude](/it/learn/cheapest-way-to-use-claude-api/)[Cursor illimitato con l'API Claude](/learn/use-claude-api-with-cursor/)[Accesso illimitato a Claude Code](/it/learn/use-claude-api-with-claude-code/)[Gateway API Claude e accesso diretto ad Anthropic a confronto](/it/learn/claude-api-vs-anthropic-direct/)[Usa Claude con l'SDK OpenAI: endpoint compatibile con OpenAI, streaming, strumenti e limiti](/it/learn/openai-compatible-claude-api/)[I modelli Claude spiegati: un confronto tra Claude Opus, Sonnet, Haiku e Fable — tutti i modelli API Claude, i nomi dei modelli Anthropic e i prezzi (2026)](/it/learn/claude-api-models-compared/)[Pagare l'API Claude con criptovalute](/it/learn/claude-api-with-crypto-payment/)[Accesso all'API Claude senza lista d'attesa](/it/learn/claude-api-without-waitlist/)[Come ridurre l'utilizzo dei token di Claude](/it/learn/how-to-reduce-claude-token-usage/)[Cline illimitato con l'API Claude](/it/learn/use-claude-api-with-cline/)[Roo Code illimitato con l'API Claude](/it/learn/use-claude-api-with-roo-code/)[Claude illimitato negli IDE JetBrains](/it/learn/use-claude-api-with-jetbrains/)[Aider con Claude tramite un gateway: ANTHROPIC_API_BASE, file di configurazione, modalità architect e soluzioni ai problemi](/it/learn/use-claude-api-with-aider/)[Claude illimitato in VS Code](/it/learn/use-claude-api-with-vscode/)[Configurazione di OpenCode per Claude: impostazione di opencode.json, modelli ed errori comuni](/it/learn/use-claude-api-with-opencode/)[Hermes Agent con Claude tramite un gateway: configurazione di un provider personalizzato, controllo dei costi e soluzioni ai problemi](/it/learn/run-hermes-agent-with-claude-api/)[Cosa significa un'API compatibile con Anthropic](/it/learn/anthropic-compatible-api/)[Chiave API di Claude Code — ANTHROPIC_API_KEY: come ottenerla, configurarla e quando usare invece claude setup-token](/it/learn/claude-code-api-key-setup/)[Costi dell'API di Claude Code — Prezzi e come ridurli](/it/learn/claude-code-api-costs/)[Gli errori dell'API Claude spiegati: errore del server 500, sovraccarico 529, limite di frequenza 429, richiesta non valida 400 — e la soluzione per ciascuno](/it/learn/claude-api-errors-troubleshooting/)[Come acquistare crediti API di Claude](/it/learn/buy-claude-api-credits/)[API Claude gratuita: esiste una chiave API di Claude gratuita e che cosa è davvero gratuito nel 2026?](/it/learn/claude-api-free-trial/)[API Claude e abbonamento Claude Pro/Max a confronto — Quale scegliere](/it/learn/claude-api-vs-subscription/)[Codex CLI con un provider personalizzato: config.toml, modelli GPT e Claude, estensione IDE e soluzioni ai problemi](/it/learn/use-claude-api-with-codex/)[Collegare Claude a n8n](/it/learn/use-claude-api-with-n8n/)[Instradare LiteLLM verso Claude](/it/learn/use-claude-api-with-litellm/)[Usare Claude in Kilo Code](/it/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat con Claude tramite un gateway: configurazione di Custom Endpoint, modalità agente e soluzioni ai problemi](/it/learn/use-claude-api-with-github-copilot/)[Collega Zed a Claude tramite il gateway](/it/learn/use-claude-api-with-zed/)[Collega Cherry Studio a Claude](/it/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: importazione, base_url, streaming, strumenti ed errori](/it/learn/use-claude-api-with-langchain/)[SDK Python di Anthropic: installazione, configurazione di base_url, streaming e gestione degli errori](/it/learn/anthropic-python-sdk/)[Claude con Vercel AI SDK: baseURL di createAnthropic, streaming e soluzioni ai problemi](/it/learn/use-claude-api-with-vercel-ai-sdk/)[Esegui Factory Droid con Claude](/it/learn/use-claude-api-with-factory-droid/)[L'API di Claude Code spiegata](/it/learn/claude-code-api/)[Integrare l'API di Claude nella tua applicazione](/it/learn/claude-api-integration/)[Come ottenere un uso illimitato di Claude](/it/learn/get-unlimited-claude-usage/)[Cosa significa accesso illimitato all'API di Claude](/it/learn/unlimited-claude-api-access/)