OpenClaw con un provider personalizzato

Aggiungi questo provider a openclaw.json e OpenClaw eseguirà i suoi agenti con i modelli Claude, GPT, Gemini e Grok tramite la tua chiave AIGROW.

Hai già un codice? Riscattalo su Accesso API, poi crea una chiave.

Il tuo openclaw.json

{
  models: {
    providers: {
      aigrow: {
        baseUrl: "https://aigrow.gg/v1",
        apiKey: "ag_your_key_here",
        api: "openai-completions",
        models: [
          { id: "claude-opus-5.5", name: "Claude Opus 5.5", contextWindow: 1000000 },
        ],
      },
    },
  },
  agents: {
    defaults: { model: { primary: "aigrow/claude-opus-5.5" } },
  },
}

Sostituisci ag_your_key_here con una chiave presa da Accesso API.

Cosa dice il filmato
  1. In questo momento ogni chiamata a Claude o GPT ti costa il prezzo di listino.
  2. Il conto cresce a ogni utente che aggiungi.
  3. Gli stessi modelli. Fino al 75% sotto il listino.
  4. Un unico endpoint perClaude, GPT, Gemini e Grok
  5. 100 USD di credito API per 25 USD. Il risparmio varia in base al modello. Nessun modello costa più del listino.
  6. Credito APII modelli Claude, GPT, Gemini e Grok con un solo endpoint, a credito prepagato. 25 USD. Inizia oggi.

Dove si trova l'impostazione

La configurazione
~/.openclaw/openclaw.json
La chiave, se la tieni fuori dalla configurazione
~/.openclaw/.env

Tieni la chiave fuori dalla configurazione

Inserisci la chiave in ~/.openclaw/.env, il file che OpenClaw consiglia per le chiavi dei provider, e scrivi ${AIGROW_API_KEY} come apiKey.

# ~/.openclaw/.env
AIGROW_API_KEY=ag_your_key_here

# openclaw.json, in the aigrow provider
apiKey: "${AIGROW_API_KEY}",

Altri modelli

Elenca sotto models tutti gli id che vuoi usare, poi cambia modello con openclaw models set, per esempio openclaw models set aigrow/claude-opus-5.5.

{
  models: {
    providers: {
      aigrow: {
        baseUrl: "https://aigrow.gg/v1",
        apiKey: "ag_your_key_here",
        api: "openai-completions",
        models: [
          { id: "claude-opus-5.5", name: "Claude Opus 5.5", contextWindow: 1000000 },
          { id: "grok-4.7", name: "Grok 4.7", contextWindow: 500000 },
          { id: "gpt-6.1-sol", name: "GPT-6.1 Sol", contextWindow: 1050000 },
        ],
      },
    },
  },
  agents: {
    defaults: { model: { primary: "aigrow/claude-opus-5.5" } },
  },
}

Quale modello usare

Inserisci l'id esattamente come è scritto qui.

Claude Opus 5.5claude-opus-5.5
È l’impostazione predefinita in ogni blocco di questa pagina e un ottimo modello principale per il lavoro con gli agenti. Contesto: 1.000.000 token.
Grok 4.7grok-4.7
Per un modello Grok. Costa meno per token ricevuto di qualsiasi modello Claude presente qui. Contesto: 500.000 token.
GPT-6.1 Solgpt-6.1-sol
Per un modello GPT. Costa meno di Opus sia per token inviato sia per token ricevuto. Contesto: 1.050.000 token.
Claude Fable 5.2claude-fable-5.2
Costa più di Opus per token. Confronta i due sulla classifica di coding prima di passare all’altro. Contesto: 1.000.000 token.

Il listino prezzi riporta ogni id con la sua tariffa in crediti, i prezzi dell'API di Claude riportano i prezzi di listino e la classifica per il coding confronta i modelli su prompt di programmazione.

Verifica che funzioni

Prima la chiave da sola, poi OpenClaw con la chiave.

La chiave

Richiedi l'elenco dei modelli. Serve una chiave valida e non costa nulla.

curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"

Con una chiave valida ricevi l'elenco:

{
  "object": "list",
  "data": [
    { "id": "claude-opus-5.5", "object": "model", ... },
    { "id": "claude-fable-5.2", "object": "model", ... },
    { "id": "claude-fable-5.1", "object": "model", ... },
    { "id": "gpt-6-astra", "object": "model", ... },
    { "id": "claude-sonnet-5.5", "object": "model", ... },
    { "id": "gpt-6.1-sol", "object": "model", ... },
    { "id": "gpt-6.1-terra", "object": "model", ... },
    { "id": "grok-4.7", "object": "model", ... },
    { "id": "gemini-4-argon", "object": "model", ... },
    ...
  ],
  "has_more": false
}

OpenClaw

Esegui un turno dal terminale. agent exec legge la stessa configurazione e non richiede un OpenClaw Gateway in esecuzione.

openclaw agent exec "Reply with the word ready" --model aigrow/claude-opus-5.5

Se la configurazione funziona, stampa la risposta e termina con codice 0:

ready

Quando non funziona

Prima gli errori di OpenClaw, poi le risposte che l'endpoint dà a qualsiasi strumento.

L'OpenClaw Gateway non si avvia dopo la modifica
OpenClaw rifiuta una configurazione con una chiave sconosciuta, un tipo errato o un valore non valido. openclaw doctor indica il problema esatto, e openclaw doctor --fix applica le riparazioni che conosce.
OpenClaw mostra un avviso su ${AIGROW_API_KEY}
La variabile manca o è vuota, quindi il provider non ha una chiave. Imposta AIGROW_API_KEY in ~/.openclaw/.env o nell'ambiente in cui si avvia OpenClaw.
openclaw models set dice che il provider è sconosciuto
Il provider deve essere prima presente in models.providers. Controlla che l'id sia aigrow sia nella configurazione sia nel riferimento al modello, come in aigrow/claude-opus-5.5.
Il mio strumento mostra un errore 401 o di autenticazione
La chiave manca o è stata digitata in modo errato. Copiala di nuovo da Accesso API nella dashboard e assicurati che venga inviata come chiave, non come nome di un modello. Una chiave revocata dà lo stesso errore: creane una nuova e sostituiscila.
Ricevo un errore 402 o un messaggio sul credito
Il tuo saldo è esaurito. Apri Accesso API nella dashboard, riscatta un codice o acquista un altro pacchetto e la richiesta successiva andrà a buon fine. Non serve cambiare nient’altro.
Compare 404 o Unknown model
Il modello deve essere uno di quelli serviti dall’endpoint, per esempio claude-opus-5.5. Funzionano anche le grafie originali del provider (claude-opus-5-5, anthropic/claude-opus-5.5), ma un id con data o qualsiasi modello fuori dal catalogo viene rifiutato prima che la richiesta sia inoltrata, e non viene addebitato nulla. Con la tua chiave richiedi GET /v1/models per l’elenco aggiornato, oppure leggi gli id nel listino.
Le richieste vengono rifiutate con errore 429
L’endpoint ti ha chiesto di rallentare. Ogni 429 include un header retry-after, e gli SDK di OpenAI e Anthropic attendono quel tempo e riprovano in automatico. In un ciclo scritto da te, attendi i secondi indicati oppure invia meno richieste alla volta. Una richiesta rifiutata non viene fatturata.
Il modello al momento non è disponibile
Un errore 404 che indica che il modello non è disponibile al momento significa che quel modello è non disponibile per un breve periodo. La tua chiave e il tuo saldo sono a posto. Riprova tra qualche istante oppure invia la richiesta a un altro modello.
Ricevo un errore 502 o 503
È un errore temporaneo e non viene mai addebitato sul tuo saldo. Riprova la richiesta; se continua a fallire, contattaci tramite lo store e verificheremo.

Cosa non funziona tramite AIGROW

  • I dati sui costi di OpenClaw. Il blocco non imposta alcun prezzo, quindi OpenClaw conteggia ogni richiesta a 0; il registro attività in Accesso API mostra quanto è costata ogni richiesta.

  • Ricerca web in tempo reale all’interno del modello. Uno strumento di ricerca web inviato con una richiesta riceve risposta da ciò che il modello già sa, senza risultati in tempo reale. Uno strumento che recupera pagine sulla tua macchina funziona comunque.

  • Qualsiasi endpoint oltre a questi tre: /v1/messages, /v1/chat/completions e /v1/models. La Responses API, gli embedding e il conteggio dei token rispondono 404.

  • I campi del router, come models, route, provider e plugins. Vengono scartati, quindi una richiesta va sempre al solo modello che indica.

Quanto costa un mese di OpenClaw

OpenClaw viene fatturato per token alle tariffe in crediti del listino prezzi. Un agente rinvia l'intera conversazione a ogni passaggio, quindi un compito lungo costa più di quanto suggerisca il suo ultimo messaggio; il registro attività su Accesso API mostra quanto è costata ogni richiesta.

Limita la spesa di OpenClaw

Assegna a OpenClaw una chiave dedicataIn Accesso API, sotto Chiavi API, crea una chiave chiamata OpenClaw, così il limite si applica solo a questo strumento.
Imposta un limite mensileInserisci un importo in dollari nel campo del limite mensile mentre crei la chiave, oppure impostalo più tardi nella riga della chiave. Un campo vuoto significa nessun limite.
Cosa succede al raggiungimento del limiteQuando la chiave ha speso il suo limite nel mese di calendario (UTC), l'endpoint risponde alle sue richieste con un errore 402 che indica il limite, e OpenClaw lo mostra. Una richiesta già in corso viene completata, quindi un mese può chiudersi un po' sopra il limite. Alza il limite o aspetta il 1° del mese; le tue altre chiavi continuano a funzionare.

Domande su OpenClaw e su un'API personalizzata

Come aggiungo un provider personalizzato a OpenClaw?
Aggiungi una voce sotto models.providers in ~/.openclaw/openclaw.json con baseUrl impostato su https://aigrow.gg/v1, api impostato su openai-completions, la tua chiave come apiKey e gli id dei modelli sotto models. Poi imposta agents.defaults.model.primary su aigrow/claude-opus-5.5.
Dove tiene OpenClaw la sua configurazione?
In ~/.openclaw/openclaw.json, un file JSON5, quindi commenti e virgole finali sono ammessi. OPENCLAW_CONFIG_PATH indica a OpenClaw un file in un'altra posizione, e l'OpenClaw Gateway applica da solo le modifiche al file.
Posso configurarlo senza modificare il file?
Sì. openclaw config set scrive un valore alla volta, e la scheda Config della Control UI su http://127.0.0.1:18789 mostra le stesse impostazioni sotto forma di modulo.
Posso limitare la spesa di OpenClaw?
Sì. Assegna a OpenClaw una chiave dedicata in Accesso API e imposta un limite mensile. Quando la chiave ha speso il suo limite in un mese di calendario (UTC), le sue richieste ricevono un errore 402 fino al 1° del mese successivo, mentre le tue altre chiavi continuano a funzionare.

Fonti: OpenClaw Custom providers · OpenClaw Configuration · OpenClaw Environment variables · OpenClaw models CLI · OpenClaw agent CLI. Consultato il 28 ottobre 2026.

Configura un altro strumento

  • Claude CodeProtocollo Anthropic

    Quattro variabili d’ambiente, nella shell o in settings.json.

  • ClineProtocollo OpenAI

    Il provider OpenAI Compatible, quattro campi nella schermata delle impostazioni.

  • Roo CodeProtocollo OpenAI

    Il provider OpenAI Compatible, con gli stessi campi di Cline.

  • Kilo CodeProtocollo OpenAI

    Un provider personalizzato nella scheda Providers; l’elenco dei modelli si compila da solo.

  • ContinueProtocollo OpenAI

    Una voce in models nel file config.yaml, con provider openai e un apiBase.

  • AiderProtocollo OpenAI

    OPENAI_API_BASE e OPENAI_API_KEY, poi openai/ prima dell’id del modello.

  • OpenCodeProtocollo OpenAI

    Un blocco provider in opencode.json e la chiave tramite /connect.

  • ZedProtocolli Anthropic e OpenAI

    Un provider compatibile con Anthropic per Claude, uno compatibile con OpenAI per GPT e Grok.

  • GooseProtocollo OpenAI

    Il provider OpenAI con OPENAI_HOST, oppure un file di provider personalizzato.

  • Vercel AI SDKProtocolli Anthropic e OpenAI

    Il provider OpenAI Compatible per ogni modello, oppure il provider Anthropic per Claude.

  • OpenAI Agents SDKProtocollo OpenAI

    Il tuo client AsyncOpenAI, passato alle chat completions, con il tracing disattivato.

  • LangChainProtocolli Anthropic e OpenAI

    ChatOpenAI con base_url per ogni modello, oppure ChatAnthropic per Claude.

La guida alle API contiene gli SDK, curl, gli endpoint e i codici di errore.

Incolla il blocco e OpenClaw funziona con il tuo credito.

Acquista un pacchetto di credito, riscatta il codice ricevuto via email su Accesso API, crea una chiave e inseriscila al posto di ag_your_key_here.