Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Per iniziare

1

Crea un account

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

Esegui l'onboarding

openclaw onboard --auth-choice kilocode-api-key
Oppure imposta direttamente la variabile di 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 fornitore e amministrato da Kilo Gateway.
OpenClaw tratta kilocode/kilo/auto come riferimento predefinito stabile, ma non pubblica una mappatura tra attività e modello upstream supportata da fonti per quella route. L’instradamento upstream esatto dietro kilocode/kilo/auto è di competenza di Kilo Gateway, non è codificato 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 di fallback statico. Il fallback incluso 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 codice sorgente come compatibile con OpenRouter, quindi rimane sul percorso proxy compatibile con OpenAI invece di usare la modellazione nativa delle richieste OpenAI.
  • I riferimenti Kilo basati su Gemini rimangono sul percorso proxy-Gemini, quindi OpenClaw mantiene lì la sanitizzazione delle firme di pensiero Gemini senza abilitare la validazione della riproduzione Gemini nativa o le riscritture 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 fornitore e normalizza i payload di ragionamento proxy per i riferimenti a modelli concreti supportati.
kilocode/kilo/auto e altri suggerimenti proxy non supportati per il ragionamento saltano l’iniezione del ragionamento. Se hai bisogno del supporto al ragionamento, usa un riferimento a modello concreto come kilocode/anthropic/claude-sonnet-4.
  • Se il rilevamento dei modelli non riesce all’avvio, OpenClaw ripiega sul catalogo statico incluso contenente kilocode/kilo/auto.
  • Conferma che la tua chiave API sia valida e che il tuo account Kilo abbia i modelli desiderati abilitati.
  • Quando il Gateway viene eseguito come daemon, assicurati che KILOCODE_API_KEY sia disponibile per quel processo (ad esempio in ~/.openclaw/.env o tramite env.shellEnv).

​
Correlati

Selezione del modello

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

Riferimento di configurazione

Riferimento completo della configurazione di OpenClaw.

Kilo Gateway

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