OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Gateway Kilo

Kilo Gateway instrada le richieste verso numerosi modelli tramite un unico endpoint compatibile con OpenAI e un'unica chiave API.

Proprietà Valore
Provider kilocode
Autenticazione KILOCODE_API_KEY
API Compatibile con OpenAI
URL di base https://api.kilo.ai/api/gateway/

Installare il plugin

bash
openclaw plugins install @openclaw/kilocode-provideropenclaw gateway restart

Configurazione

  • Creare un account

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

  • Eseguire la configurazione iniziale

    bash
    openclaw onboard --auth-choice kilocode-api-key

    In alternativa, imposta direttamente la variabile di ambiente:

    bash
    export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret

  • Verificare che il modello sia disponibile

    bash
    openclaw models list --provider kilocode

    • 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

    json5
    {  env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret  agents: {    defaults: {      model: { primary: "kilocode/kilo/auto" },    },  },}

    Note sul comportamento

    Trasporto e compatibilità

    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.
    Wrapper del flusso e ragionamento

    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.

    Risoluzione dei problemi
    • 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.
    Was this useful?
    On this page

    On this page