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

Providers

Gateway Kilo

O Kilo Gateway encaminha solicitações para vários modelos por meio de um único endpoint compatível com OpenAI e uma única chave de API.

Propriedade Valor
Provedor kilocode
Autenticação KILOCODE_API_KEY
API Compatível com OpenAI
URL base https://api.kilo.ai/api/gateway/

Instalar o Plugin

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

Configuração

  • Criar uma conta

    Acesse app.kilo.ai, entre ou crie uma conta e gere uma chave de API.

  • Executar a integração inicial

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

    Ou defina a variável de ambiente diretamente:

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

  • Verificar se o modelo está disponível

    bash
    openclaw models list --provider kilocode

    • O modelo padrão é kilocode/kilo/auto, um modelo de roteamento inteligente gerenciado pelo provedor. O OpenClaw não publica um mapeamento entre tarefas e modelos upstream para ele; o roteamento por trás de kilo/auto é gerenciado pelo Kilo Gateway.

    Na inicialização, o OpenClaw consulta GET https://api.kilo.ai/api/gateway/models e mescla os modelos descobertos antes de um catálogo de contingência estático. Esse catálogo contém apenas kilocode/kilo/auto (Kilo Auto, input: ["text", "image"], reasoning: true, contextWindow: 1000000, maxTokens: 128000).

    Qualquer modelo no Gateway pode ser acessado como kilocode/<upstream-id> (por exemplo, kilocode/anthropic/claude-sonnet-4, kilocode/openai/gpt-5.5). Execute /models kilocode ou openclaw models list --provider kilocode para ver a lista completa de modelos descobertos.

    Exemplo de configuração

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

    Observações sobre o comportamento

    Transporte e compatibilidade

    O Kilo Gateway é compatível com o OpenRouter, portanto usa o caminho de solicitação compatível com OpenAI no estilo proxy, em vez da formatação nativa de solicitações do OpenAI (sem store e sem carga de esforço de raciocínio do OpenAI).

    • As referências do Kilo baseadas no Gemini permanecem no caminho proxy-Gemini: o OpenClaw higieniza as assinaturas de pensamento do Gemini nesse caminho, mas não habilita a validação nativa de repetição do Gemini nem regravações de inicialização.
    • As solicitações usam um token Bearer criado a partir da sua chave de API.
    Wrapper de streaming e raciocínio

    O wrapper de streaming do Kilo adiciona o cabeçalho de solicitação X-KILOCODE-FEATURE (o padrão é openclaw, substituível pela variável de ambiente KILOCODE_FEATURE) e normaliza as cargas de esforço de raciocínio para modelos compatíveis.

    Solução de problemas
    • Se a descoberta de modelos falhar na inicialização, o OpenClaw recorrerá ao catálogo estático que contém kilocode/kilo/auto.
    • Confirme se sua chave de API é válida e se os modelos desejados estão habilitados em sua conta do Kilo.
    • 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 por meio de env.shellEnv).

    Relacionados

    Seleção de modelos

    Como escolher provedores, referências de modelos e o 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 da conta.
    Was this useful?
    On this page

    On this page