Pular para o conteúdo principal
Moonshot fornece a API Kimi com endpoints compatíveis com OpenAI. Configure o provedor e defina o modelo padrão como moonshot/kimi-k2.6, ou use Kimi Coding com kimi/kimi-for-coding.
Moonshot e Kimi Coding são provedores separados. As chaves não são intercambiáveis, os endpoints diferem e as refs de modelo diferem (moonshot/... vs kimi/...).

​
Catálogo de modelos integrado

Ref do modeloNomeRaciocínioEntradaContextoSaída máxima
moonshot/kimi-k2.6Kimi K2.6Nãotexto, imagem262,144262,144
moonshot/kimi-k2.7-codeKimi K2.7 CodeSempre ativotexto, imagem262,144262,144
moonshot/kimi-k2.5Kimi K2.5Nãotexto, imagem262,144262,144
moonshot/kimi-k2-thinkingKimi K2 ThinkingSimtexto262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking TurboSimtexto262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboNãotexto256,00016,384
As estimativas de custo do catálogo para os modelos K2 atuais hospedados pela Moonshot usam as tarifas publicadas de pagamento conforme o uso da Moonshot: Kimi K2.7 Code custa US0,19/MTokparaacertodecache,US 0,19/MTok para acerto de cache, US 0,95/MTok de entrada e US4,00/MTokdesaıˊda;KimiK2.6custaUS 4,00/MTok de saída; Kimi K2.6 custa US 0,16/MTok para acerto de cache, US0,95/MTokdeentradaeUS 0,95/MTok de entrada e US 4,00/MTok de saída; Kimi K2.5 custa US0,10/MTokparaacertodecache,US 0,10/MTok para acerto de cache, US 0,60/MTok de entrada e US$ 3,00/MTok de saída. Outras entradas legadas do catálogo mantêm marcadores de custo zero, a menos que você os substitua na configuração. Kimi K2.7 Code sempre usa pensamento nativo. O OpenClaw expõe apenas o estado de pensamento on para este modelo e omite os controles de saída thinking e reasoning_effort, conforme exigido pela Moonshot. O OpenClaw também omite substituições de amostragem que o K2.7 fixa nos padrões do provedor. Kimi K2.6 continua sendo o padrão de onboarding.

​
Primeiros passos

Escolha seu provedor e siga as etapas de configuração.
Melhor para: modelos Kimi K2 via Moonshot Open Platform.
1

Escolha a região do seu endpoint

Opção de autenticaçãoEndpointRegião
moonshot-api-keyhttps://api.moonshot.ai/v1Internacional
moonshot-api-key-cnhttps://api.moonshot.cn/v1China
2

Execute o onboarding

openclaw onboard --auth-choice moonshot-api-key
Ou para o endpoint da China:
openclaw onboard --auth-choice moonshot-api-key-cn
3

Defina um modelo padrão

{
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.6" },
    },
  },
}
4

Verifique se os modelos estão disponíveis

openclaw models list --provider moonshot
5

Execute um teste smoke ao vivo

Use um diretório de estado isolado quando quiser verificar o acesso ao modelo e o rastreamento de custos sem tocar nas suas sessões normais:
OPENCLAW_CONFIG_PATH=/tmp/openclaw-kimi/openclaw.json \
OPENCLAW_STATE_DIR=/tmp/openclaw-kimi \
openclaw agent --local \
  --session-id live-kimi-cost \
  --message 'Reply exactly: KIMI_LIVE_OK' \
  --thinking off \
  --json
A resposta JSON deve relatar provider: "moonshot" e model: "kimi-k2.6". A entrada da transcrição do assistente armazena o uso de tokens normalizado mais o custo estimado em usage.cost quando a Moonshot retorna metadados de uso.

​
Exemplo de configuração

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.6" },
      models: {
        // moonshot-kimi-k2-aliases:start
        "moonshot/kimi-k2.6": { alias: "Kimi K2.6" },
        "moonshot/kimi-k2.7-code": { alias: "Kimi K2.7 Code" },
        "moonshot/kimi-k2.5": { alias: "Kimi K2.5" },
        "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" },
        "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" },
        "moonshot/kimi-k2-turbo": { alias: "Kimi K2 Turbo" },
        // moonshot-kimi-k2-aliases:end
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [
          // moonshot-kimi-k2-models:start
          {
            id: "kimi-k2.6",
            name: "Kimi K2.6",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0.95, output: 4, cacheRead: 0.16, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2.7-code",
            name: "Kimi K2.7 Code",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0.95, output: 4, cacheRead: 0.19, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0.6, output: 3, cacheRead: 0.1, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-thinking",
            name: "Kimi K2 Thinking",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-thinking-turbo",
            name: "Kimi K2 Thinking Turbo",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-turbo",
            name: "Kimi K2 Turbo",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 16384,
          },
          // moonshot-kimi-k2-models:end
        ],
      },
    },
  },
}

​
Pesquisa na web do Kimi

O plugin Moonshot também registra Kimi como um provedor web_search, apoiado pela pesquisa na web da Moonshot.
1

Execute a configuração interativa de pesquisa na web

openclaw configure --section web
Escolha Kimi na seção de pesquisa na web para armazenar plugins.entries.moonshot.config.webSearch.*.
2

Configure a região e o modelo da pesquisa na web

A configuração interativa solicita:
ConfiguraçãoOpções
Região da APIhttps://api.moonshot.ai/v1 (internacional) ou https://api.moonshot.cn/v1 (China)
Modelo de pesquisa na webO padrão é kimi-k2.6
A configuração fica em plugins.entries.moonshot.config.webSearch: 
{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // or use KIMI_API_KEY / MOONSHOT_API_KEY
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.6",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

​
Configuração avançada

Kimi K2.7 Code sempre usa pensamento nativo. A Moonshot exige que os clientes omitam o campo thinking para este modelo, então o OpenClaw expõe apenas on e ignora configurações obsoletas off. O K2.7 também fixa temperature, top_p, n, presence_penalty e frequency_penalty; o OpenClaw omite substituições configuradas para esses campos.Outros modelos Moonshot Kimi dão suporte a pensamento nativo binário:
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
Configure-o por modelo via agents.defaults.models.<provider/model>.params:
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
O OpenClaw mapeia níveis de /think em tempo de execução para esses modelos:
Nível de /thinkComportamento da Moonshot
/think offthinking.type=disabled
Qualquer nível diferente de offthinking.type=enabled
Quando o pensamento da Moonshot está habilitado, tool_choice deve ser auto ou none. O OpenClaw normaliza valores incompatíveis para auto. Isso inclui Kimi K2.7 Code, cujo modo de pensamento não pode ser desabilitado para preservar uma escolha de ferramenta fixada.
O Kimi K2.6 também aceita um campo opcional thinking.keep que controla a retenção multi-turn de reasoning_content. Defina-o como "all" para manter o reasoning completo entre turnos; omita-o (ou deixe-o como null) para usar a estratégia padrão do servidor. O OpenClaw só encaminha thinking.keep para moonshot/kimi-k2.6 e o remove de outros modelos. O Kimi K2.7 Code preserva o histórico completo de reasoning por padrão, enquanto o OpenClaw omite todo o campo thinking.
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
O Moonshot Kimi serve ids tool_call nativos no formato functions.<name>:<index>. Para o transporte OpenAI-completions, o OpenClaw preserva a primeira ocorrência de cada id nativo do Kimi e reescreve duplicatas posteriores para ids determinísticos call_* no estilo OpenAI. Resultados de ferramenta correspondentes são remapeados com o mesmo id, para que a reprodução permaneça única sem remover o primeiro id nativo do Kimi.Para forçar sanitização estrita em um provedor personalizado compatível com OpenAI, defina sanitizeToolCallIds: true:
{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}
Endpoints nativos da Moonshot (https://api.moonshot.ai/v1 e https://api.moonshot.cn/v1) anunciam compatibilidade de uso em streaming no transporte compartilhado openai-completions. O OpenClaw determina isso a partir das capacidades do endpoint, então ids de provedores personalizados compatíveis que apontam para os mesmos hosts nativos da Moonshot herdam o mesmo comportamento de uso em streaming.Com os preços do catálogo K2.6, o uso transmitido por streaming que inclui tokens de entrada, saída e leitura de cache também é convertido em custo estimado local em USD para /status, /usage full, /usage cost e contabilidade de sessão baseada em transcrições.
ProvedorPrefixo de ref de modeloEndpointVariável de ambiente de autenticação
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Endpoint Kimi CodingKIMI_API_KEY
Pesquisa na webN/AIgual à região da API MoonshotKIMI_API_KEY ou MOONSHOT_API_KEY
  • A pesquisa na web do Kimi usa KIMI_API_KEY ou MOONSHOT_API_KEY, e o padrão é https://api.moonshot.ai/v1 com o modelo kimi-k2.6.
  • Substitua preços e metadados de contexto em models.providers se necessário.
  • Se a Moonshot publicar limites de contexto diferentes para um modelo, ajuste contextWindow conforme apropriado.

​
Relacionado

Seleção de modelo

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

Pesquisa na web

Configuração de provedores de pesquisa na web, incluindo Kimi.

Referência de configuração

Esquema completo de configuração para provedores, modelos e plugins.

Moonshot Open Platform

Gerenciamento de chaves de API da Moonshot e documentação.