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.

// ~/.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

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.