Vai al contenuto principale
Kilo Gateway fornisce un’API unificata che instrada le richieste verso molti modelli dietro un singolo endpoint e una chiave API. È compatibile con OpenAI, quindi la maggior parte degli SDK OpenAI funziona cambiando l’URL base.
ProprietàValore
Providerkilocode
AutenticazioneKILOCODE_API_KEY
APICompatibile con OpenAI
URL basehttps://api.kilo.ai/api/gateway/

​
Installa il Plugin

Installa il Plugin ufficiale, quindi riavvia Gateway: 
openclaw plugins install @openclaw/kilocode-provider
openclaw gateway restart

​
Introduzione

1

Crea un account

Vai su app.kilo.ai, accedi o crea un account, quindi passa a API Keys e genera una nuova chiave.
2

Esegui l'onboarding

openclaw onboard --auth-choice kilocode-api-key
Oppure imposta direttamente la variabile d’ambiente:
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
3

Verifica che il modello sia disponibile

openclaw models list --provider kilocode

​
Modello predefinito

Il modello predefinito è kilocode/kilo/auto, un modello di instradamento intelligente gestito dal provider e amministrato da Kilo Gateway.
OpenClaw tratta kilocode/kilo/auto come riferimento predefinito stabile, ma non pubblica una mappatura, supportata da fonti, tra attività e modello upstream per quella route. L’esatto instradamento upstream dietro kilocode/kilo/auto è di proprietà di Kilo Gateway, non codificato in modo rigido in OpenClaw.

​
Catalogo integrato

OpenClaw rileva dinamicamente i modelli disponibili da Kilo Gateway all’avvio. Usa /models kilocode per vedere l’elenco completo dei modelli disponibili con il tuo account. Qualsiasi modello disponibile sul gateway può essere usato con il prefisso kilocode/:
Riferimento modelloNote
kilocode/kilo/autoPredefinito — instradamento intelligente
kilocode/anthropic/claude-sonnet-4Anthropic tramite Kilo
kilocode/openai/gpt-5.5OpenAI tramite Kilo
kilocode/google/gemini-3.1-pro-previewGoogle tramite Kilo
…e molti altriUsa /models kilocode per elencarli tutti
All’avvio, OpenClaw interroga GET https://api.kilo.ai/api/gateway/models e unisce i modelli rilevati prima del catalogo statico di fallback. Il fallback statico include sempre kilocode/kilo/auto (Kilo Auto) con input: ["text", "image"], reasoning: true, contextWindow: 1000000 e maxTokens: 128000.

​
Esempio di configurazione

{
  env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
  agents: {
    defaults: {
      model: { primary: "kilocode/kilo/auto" },
    },
  },
}
Kilo Gateway è documentato nel sorgente come compatibile con OpenRouter, quindi resta sul percorso in stile proxy compatibile con OpenAI invece della modellazione nativa delle richieste OpenAI.
  • I riferimenti Kilo basati su Gemini restano sul percorso proxy-Gemini, quindi OpenClaw mantiene lì la sanificazione delle firme di pensiero Gemini senza abilitare la convalida nativa della riproduzione Gemini o riscritture di bootstrap.
  • Kilo Gateway usa internamente un token Bearer con la tua chiave API.
Il wrapper di stream condiviso di Kilo aggiunge l’header dell’app del provider e normalizza i payload di ragionamento proxy per i riferimenti a modelli concreti supportati.
kilocode/kilo/auto e altri suggerimenti proxy non supportati dal ragionamento saltano l’iniezione del ragionamento. Se hai bisogno del supporto al ragionamento, usa un riferimento a un modello concreto come kilocode/anthropic/claude-sonnet-4.
  • Se il rilevamento dei modelli fallisce all’avvio, OpenClaw ripiega sul catalogo statico contenente kilocode/kilo/auto.
  • Conferma che la tua chiave API sia valida e che il tuo account Kilo abbia i modelli desiderati abilitati.
  • Quando Gateway viene eseguito come demone, assicurati che KILOCODE_API_KEY sia disponibile per quel processo (per esempio in ~/.openclaw/.env o tramite env.shellEnv).

​
Correlati

Selezione del modello

Scelta dei provider, dei riferimenti modello e del comportamento di failover.

Riferimento di configurazione

Riferimento completo della configurazione di OpenClaw.

Kilo Gateway

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