Skip to main content
Kilo Gateway instrada le richieste verso numerosi modelli tramite un unico endpoint compatibile con OpenAI e un’unica chiave API.

​
Installare il plugin

​
Configurazione

1

Creare un account

Vai su app.kilo.ai, accedi o crea un account, quindi genera una chiave API.
2

Eseguire la configurazione iniziale

In alternativa, imposta direttamente la variabile di ambiente:
3

Verificare che il modello sia disponibile

Il modello predefinito è kilocode/kilo/auto, un modello di instradamento intelligente gestito dal provider. OpenClaw non pubblica una mappatura tra attività e modello upstream; l’instradamento sottostante a kilo/auto è gestito da Kilo Gateway. All’avvio, OpenClaw interroga GET https://api.kilo.ai/api/gateway/models e inserisce i modelli individuati prima di un catalogo statico di ripiego. Il catalogo statico di ripiego contiene solo kilocode/kilo/auto (Kilo Auto, input: ["text", "image"], reasoning: true, contextWindow: 1000000, maxTokens: 128000). È possibile fare riferimento a qualsiasi modello del Gateway come kilocode/<upstream-id> (ad esempio kilocode/anthropic/claude-sonnet-4, kilocode/openai/gpt-5.5). Esegui /models kilocode oppure openclaw models list --provider kilocode per visualizzare l’elenco completo dei modelli individuati.

​
Esempio di configurazione

​
Note sul comportamento

Kilo Gateway è compatibile con OpenRouter, pertanto utilizza il percorso delle richieste compatibile con OpenAI in stile proxy anziché il formato nativo delle richieste OpenAI (senza store e senza payload OpenAI relativo all’intensità di ragionamento).
  • I riferimenti Kilo basati su Gemini rimangono sul percorso proxy-Gemini: OpenClaw corregge le firme di ragionamento Gemini in tale percorso, ma non abilita la convalida nativa della riproduzione Gemini né le riscritture di bootstrap.
  • Le richieste utilizzano un token Bearer creato a partire dalla chiave API.
Il wrapper del flusso Kilo aggiunge alle richieste l’intestazione X-KILOCODE-FEATURE (il valore predefinito è openclaw, modificabile tramite la variabile di ambiente KILOCODE_FEATURE) e normalizza i payload relativi all’intensità di ragionamento per i modelli che la supportano.
I riferimenti kilocode/kilo/auto e x-ai/* non prevedono l’inserimento dell’intensità di ragionamento. Se ti serve il supporto al ragionamento, utilizza il riferimento a un modello specifico, ad esempio kilocode/anthropic/claude-sonnet-4.
  • Se l’individuazione dei modelli non riesce all’avvio, OpenClaw utilizza il catalogo statico di ripiego contenente kilocode/kilo/auto.
  • Verifica che la chiave API sia valida e che i modelli desiderati siano abilitati nel tuo account Kilo.
  • Quando il Gateway viene eseguito come daemon, assicurati che KILOCODE_API_KEY sia disponibile per tale processo (ad esempio in ~/.openclaw/.env o tramite env.shellEnv).

​
Contenuti correlati

Selezione del modello

Scelta dei provider, dei riferimenti ai modelli e del comportamento di failover.

Riferimento per la configurazione

Riferimento completo per la configurazione di OpenClaw.

Kilo Gateway

Pannello di controllo di Kilo Gateway, chiavi API e gestione dell’account.