Pular para o conteúdo principal

Kilo Gateway

O Kilo Gateway fornece uma API unificada que encaminha solicitações para muitos modelos por trás de um único endpoint e de uma única chave de API. Ela é compatível com OpenAI, então a maioria dos SDKs OpenAI funciona apenas trocando a base URL.
PropriedadeValor
Provedorkilocode
AuthKILOCODE_API_KEY
APIcompatível com OpenAI
Base URLhttps://api.kilo.ai/api/gateway/

Primeiros passos

1

Crie uma conta

Acesse app.kilo.ai, entre ou crie uma conta e depois navegue até API Keys para gerar uma nova chave.
2

Execute o onboarding

openclaw onboard --auth-choice kilocode-api-key
Ou defina a variável de ambiente diretamente:
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
3

Verifique se o modelo está disponível

openclaw models list --provider kilocode

Modelo padrão

O modelo padrão é kilocode/kilo/auto, um modelo de roteamento inteligente pertencente ao provedor e gerenciado pelo Kilo Gateway.
O OpenClaw trata kilocode/kilo/auto como a ref padrão estável, mas não publica um mapeamento respaldado no código-fonte entre tarefa e modelo upstream para essa rota. O roteamento upstream exato por trás de kilocode/kilo/auto pertence ao Kilo Gateway, não está hardcoded no OpenClaw.

Modelos disponíveis

O OpenClaw descobre dinamicamente os modelos disponíveis no Kilo Gateway na inicialização. Use /models kilocode para ver a lista completa de modelos disponíveis com a sua conta. Qualquer modelo disponível no gateway pode ser usado com o prefixo kilocode/:
Model refObservações
kilocode/kilo/autoPadrão — roteamento inteligente
kilocode/anthropic/claude-sonnet-4Anthropic via Kilo
kilocode/openai/gpt-5.4OpenAI via Kilo
kilocode/google/gemini-3-pro-previewGoogle via Kilo
…and many moreUse /models kilocode para listar todos
Na inicialização, o OpenClaw consulta GET https://api.kilo.ai/api/gateway/models e mescla os modelos descobertos antes do catálogo estático de fallback. O fallback integrado sempre inclui kilocode/kilo/auto (Kilo Auto) com input: ["text", "image"], reasoning: true, contextWindow: 1000000 e maxTokens: 128000.

Exemplo de configuração

{
  env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
  agents: {
    defaults: {
      model: { primary: "kilocode/kilo/auto" },
    },
  },
}
O Kilo Gateway é documentado no código-fonte como compatível com OpenRouter, então ele permanece no caminho no estilo proxy compatível com OpenAI, em vez do formato nativo de solicitações do OpenAI.
  • Refs do Kilo com backend Gemini permanecem no caminho proxy-Gemini, então o OpenClaw mantém a sanitização de thought-signature do Gemini ali sem ativar a validação nativa de replay do Gemini nem reescritas de bootstrap.
  • O Kilo Gateway usa um token Bearer com sua chave de API internamente.
O wrapper de stream compartilhado do Kilo adiciona o cabeçalho do app do provedor e normaliza payloads de raciocínio de proxy para refs concretas de modelo compatíveis.
kilocode/kilo/auto e outras dicas incompatíveis com raciocínio de proxy ignoram a injeção de raciocínio. Se você precisar de suporte a raciocínio, use uma ref concreta de modelo como kilocode/anthropic/claude-sonnet-4.
  • Se a descoberta de modelos falhar na inicialização, o OpenClaw usa fallback para o catálogo estático integrado que contém kilocode/kilo/auto.
  • Confirme que sua chave de API é válida e que a sua conta do Kilo tem os modelos desejados ativados.
  • Quando o Gateway for executado como daemon, certifique-se de que KILOCODE_API_KEY esteja disponível para esse processo (por exemplo em ~/.openclaw/.env ou via env.shellEnv).

Relacionado

Seleção de modelo

Escolha de provedores, refs de modelo e comportamento de failover.

Referência de configuração

Referência completa de configuração do OpenClaw.

Kilo Gateway

Painel do Kilo Gateway, chaves de API e gerenciamento de conta.