Vai al contenuto principale
Moonshot fornisce l’API Kimi con endpoint compatibili con OpenAI. Configura il provider e imposta il modello predefinito su moonshot/kimi-k2.6, oppure usa Kimi Coding con kimi/kimi-for-coding.
Moonshot e Kimi Coding sono provider separati. Le chiavi non sono intercambiabili, gli endpoint sono diversi e i riferimenti dei modelli differiscono (moonshot/... rispetto a kimi/...).

​
Catalogo dei modelli integrato

Riferimento modelloNomeRagionamentoInputContestoOutput massimo
moonshot/kimi-k2.6Kimi K2.6Notesto, immagine262,144262,144
moonshot/kimi-k2.7-codeKimi K2.7 CodeSempre attivotesto, immagine262,144262,144
moonshot/kimi-k2.5Kimi K2.5Notesto, immagine262,144262,144
moonshot/kimi-k2-thinkingKimi K2 ThinkingSìtesto262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking TurboSìtesto262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboNotesto256,00016,384
Le stime dei costi del catalogo per gli attuali modelli K2 ospitati da Moonshot usano le tariffe a consumo pubblicate da Moonshot: Kimi K2.7 Code costa 0.19/MTokpercachehit,0.19/MTok per cache hit, 0.95/MTok per input e 4.00/MTokperoutput;KimiK2.6costa4.00/MTok per output; Kimi K2.6 costa 0.16/MTok per cache hit, 0.95/MTokperinpute0.95/MTok per input e 4.00/MTok per output; Kimi K2.5 costa 0.10/MTokpercachehit,0.10/MTok per cache hit, 0.60/MTok per input e $3.00/MTok per output. Le altre voci legacy del catalogo mantengono segnaposto a costo zero, salvo override nella configurazione. Kimi K2.7 Code usa sempre il thinking nativo. OpenClaw espone solo lo stato di thinking on per questo modello e omette i controlli in uscita thinking e reasoning_effort, come richiesto da Moonshot. OpenClaw omette anche gli override di campionamento che K2.7 fissa sui valori predefiniti del provider. Kimi K2.6 rimane il valore predefinito dell’onboarding.

​
Per iniziare

Scegli il provider e segui i passaggi di configurazione.
Ideale per: modelli Kimi K2 tramite Moonshot Open Platform.
1

Scegli la regione dell'endpoint

Scelta di autenticazioneEndpointRegione
moonshot-api-keyhttps://api.moonshot.ai/v1Internazionale
moonshot-api-key-cnhttps://api.moonshot.cn/v1Cina
2

Esegui l'onboarding

openclaw onboard --auth-choice moonshot-api-key
Oppure per l’endpoint Cina:
openclaw onboard --auth-choice moonshot-api-key-cn
3

Imposta un modello predefinito

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

Verifica che i modelli siano disponibili

openclaw models list --provider moonshot
5

Esegui uno smoke test live

Usa una directory di stato isolata quando vuoi verificare l’accesso al modello e il tracciamento dei costi senza toccare le sessioni normali:
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
La risposta JSON dovrebbe indicare provider: "moonshot" e model: "kimi-k2.6". La voce della trascrizione dell’assistente archivia l’uso normalizzato dei token più il costo stimato in usage.cost quando Moonshot restituisce metadati di utilizzo.

​
Esempio di configurazione

{
  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
        ],
      },
    },
  },
}

​
Ricerca web Kimi

Il plugin Moonshot registra anche Kimi come provider web_search, basato sulla ricerca web Moonshot.
1

Esegui la configurazione interattiva della ricerca web

openclaw configure --section web
Scegli Kimi nella sezione della ricerca web per archiviare plugins.entries.moonshot.config.webSearch.*.
2

Configura la regione e il modello della ricerca web

La configurazione interattiva richiede:
ImpostazioneOpzioni
Regione APIhttps://api.moonshot.ai/v1 (internazionale) o https://api.moonshot.cn/v1 (Cina)
Modello di ricerca webValore predefinito kimi-k2.6
La configurazione si trova in 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",
      },
    },
  },
}

​
Configurazione avanzata

Kimi K2.7 Code usa sempre il thinking nativo. Moonshot richiede ai client di omettere il campo thinking per questo modello, quindi OpenClaw espone solo on e ignora le impostazioni off obsolete. K2.7 fissa anche temperature, top_p, n, presence_penalty e frequency_penalty; OpenClaw omette gli override configurati per questi campi.Gli altri modelli Moonshot Kimi supportano il thinking nativo binario:
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
Configuralo per modello tramite agents.defaults.models.<provider/model>.params:
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
OpenClaw mappa i livelli runtime /think per questi modelli:
Livello /thinkComportamento Moonshot
/think offthinking.type=disabled
Qualsiasi livello non-offthinking.type=enabled
Quando il thinking Moonshot è abilitato, tool_choice deve essere auto o none. OpenClaw normalizza i valori incompatibili in auto. Questo include Kimi K2.7 Code, la cui modalità thinking non può essere disabilitata per preservare una scelta di strumento fissata.
Kimi K2.6 accetta anche un campo opzionale thinking.keep che controlla la conservazione multi-turn di reasoning_content. Impostalo su "all" per mantenere il ragionamento completo tra i turni; omettilo (o lascialo null) per usare la strategia predefinita del server. OpenClaw inoltra thinking.keep solo per moonshot/kimi-k2.6 e lo rimuove dagli altri modelli. Kimi K2.7 Code conserva per impostazione predefinita la cronologia completa del ragionamento, mentre OpenClaw omette l’intero campo thinking.
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
Moonshot Kimi fornisce id tool_call nativi con formato functions.<name>:<index>. Per il trasporto OpenAI-completions, OpenClaw conserva la prima occorrenza di ogni id Kimi nativo e riscrive i duplicati successivi in id call_* deterministici in stile OpenAI. I risultati degli strumenti corrispondenti vengono rimappati con lo stesso id, così la riproduzione rimane univoca senza rimuovere il primo id nativo di Kimi.Per forzare la sanificazione rigorosa su un provider personalizzato compatibile con OpenAI, imposta sanitizeToolCallIds: true:
{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}
Gli endpoint Moonshot nativi (https://api.moonshot.ai/v1 e https://api.moonshot.cn/v1) dichiarano la compatibilità dell’utilizzo in streaming sul trasporto condiviso openai-completions. OpenClaw la determina in base alle capacità dell’endpoint, quindi gli id di provider personalizzati compatibili che puntano agli stessi host Moonshot nativi ereditano lo stesso comportamento di utilizzo in streaming.Con i prezzi K2.6 del catalogo, l’utilizzo in streaming che include token di input, output e lettura dalla cache viene anche convertito in una stima locale del costo in USD per /status, /usage full, /usage cost e la contabilizzazione delle sessioni basata sulle trascrizioni.
ProviderPrefisso model refEndpointVariabile env di autenticazione
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Endpoint Kimi CodingKIMI_API_KEY
Ricerca webN/DUguale alla regione dell’API MoonshotKIMI_API_KEY o MOONSHOT_API_KEY
  • La ricerca web di Kimi usa KIMI_API_KEY o MOONSHOT_API_KEY e per impostazione predefinita usa https://api.moonshot.ai/v1 con il modello kimi-k2.6.
  • Sovrascrivi prezzi e metadati del contesto in models.providers se necessario.
  • Se Moonshot pubblica limiti di contesto diversi per un modello, modifica contextWindow di conseguenza.

​
Correlati

Selezione del modello

Scelta dei provider, dei model ref e del comportamento di failover.

Ricerca web

Configurazione dei provider di ricerca web, incluso Kimi.

Riferimento di configurazione

Schema di configurazione completo per provider, modelli e plugin.

Moonshot Open Platform

Gestione e documentazione delle chiavi API Moonshot.