Providers

Moonshot AI

Moonshot proporciona la API de Kimi con endpoints compatibles con OpenAI. Configura el proveedor y establece el modelo predeterminado en moonshot/kimi-k2.6, o usa Kimi Coding con kimi/kimi-for-coding.

Catálogo de modelos integrado

Referencia de modelo	Nombre	Razonamiento	Entrada	Contexto	Salida máxima
`moonshot/kimi-k2.6`	Kimi K2.6	No	texto, imagen	262,144	262,144
`moonshot/kimi-k2.7-code`	Kimi K2.7 Code	Siempre activo	texto, imagen	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	No	texto, imagen	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	Sí	texto	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	Sí	texto	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	No	texto	256,000	16,384

Las estimaciones de costo del catálogo para los modelos K2 actuales alojados por Moonshot usan las tarifas publicadas de pago por uso de Moonshot: Kimi K2.7 Code cuesta $0.19/MTok por acierto de caché, $0.95/MTok de entrada y $4.00/MTok de salida; Kimi K2.6 cuesta $0.16/MTok por acierto de caché, $0.95/MTok de entrada y $4.00/MTok de salida; Kimi K2.5 cuesta $0.10/MTok por acierto de caché, $0.60/MTok de entrada y $3.00/MTok de salida. Otras entradas heredadas del catálogo conservan marcadores de posición de costo cero salvo que los sobrescribas en la configuración.

Kimi K2.7 Code siempre usa pensamiento nativo. OpenClaw expone solo el estado de pensamiento on para este modelo y omite los controles salientes thinking y reasoning_effort, según lo exige Moonshot. OpenClaw también omite las sobrescrituras de muestreo que K2.7 fija a los valores predeterminados del proveedor. Kimi K2.6 sigue siendo el valor predeterminado de incorporación.

Primeros pasos

Elige tu proveedor y sigue los pasos de configuración.

Moonshot API

Recomendado para: modelos Kimi K2 mediante Moonshot Open Platform.

Choose your endpoint region

Opción de autenticación	Endpoint	Región
`moonshot-api-key`	`https://api.moonshot.ai/v1`	Internacional
`moonshot-api-key-cn`	`https://api.moonshot.cn/v1`	China

Run onboarding

bash

openclaw onboard --auth-choice moonshot-api-key

O para el endpoint de China:

bash

openclaw onboard --auth-choice moonshot-api-key-cn

Set a default model

json5

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

Verify models are available

bash

openclaw models list --provider moonshot

Run a live smoke test

Usa un directorio de estado aislado cuando quieras verificar el acceso al modelo y el seguimiento de costos sin tocar tus sesiones normales:

bash

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 respuesta JSON debería informar provider: "moonshot" y model: "kimi-k2.6". La entrada de transcripción del asistente almacena el uso de tokens normalizado más el costo estimado en usage.cost cuando Moonshot devuelve metadatos de uso.

Ejemplo de configuración

json5

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

Kimi Coding

Instala el Plugin oficial y luego reinicia Gateway:

bash

openclaw plugins install @openclaw/kimi-provideropenclaw gateway restart

Recomendado para: tareas enfocadas en código mediante el endpoint de Kimi Coding.

Install the plugin

bash

openclaw plugins install @openclaw/kimi-provider

Run onboarding

bash

openclaw onboard --auth-choice kimi-code-api-key

Set a default model

json5

{  agents: {    defaults: {      model: { primary: "kimi/kimi-for-coding" },    },  },}

Verify the model is available

bash

openclaw models list --provider kimi

Ejemplo de configuración

json5

{  env: { KIMI_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "kimi/kimi-for-coding" },      models: {        "kimi/kimi-for-coding": { alias: "Kimi" },      },    },  },}

Búsqueda web de Kimi

El Plugin de Moonshot también registra Kimi como proveedor de web_search, respaldado por la búsqueda web de Moonshot.

Run interactive web search setup

bash

openclaw configure --section web

Elige Kimi en la sección de búsqueda web para almacenar plugins.entries.moonshot.config.webSearch.*.

Configure the web search region and model

La configuración interactiva solicita:

Configuración	Opciones
Región de API	`https://api.moonshot.ai/v1` (internacional) o `https://api.moonshot.cn/v1` (China)
Modelo de búsqueda web	Valor predeterminado: `kimi-k2.6`

La configuración reside en plugins.entries.moonshot.config.webSearch:

json5

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

Configuración avanzada

Native thinking mode

Kimi K2.7 Code siempre usa pensamiento nativo. Moonshot exige que los clientes omitan el campo thinking para este modelo, por lo que OpenClaw expone solo on e ignora configuraciones off obsoletas. K2.7 también fija temperature, top_p, n, presence_penalty y frequency_penalty; OpenClaw omite las sobrescrituras configuradas para esos campos.

Otros modelos Kimi de Moonshot admiten pensamiento nativo binario:

thinking: { type: "enabled" }
thinking: { type: "disabled" }

Configúralo por modelo mediante agents.defaults.models.<provider/model>.params:

json5

{  agents: {    defaults: {      models: {        "moonshot/kimi-k2.6": {          params: {            thinking: { type: "disabled" },          },        },      },    },  },}

OpenClaw asigna los niveles de /think en tiempo de ejecución para esos modelos:

Nivel de `/think`	Comportamiento de Moonshot
`/think off`	`thinking.type=disabled`
Cualquier nivel que no sea off	`thinking.type=enabled`

Kimi K2.6 también acepta un campo opcional thinking.keep que controla la retención multiturno de reasoning_content. Configúralo como "all" para conservar el razonamiento completo entre turnos; omítelo (o déjalo en null) para usar la estrategia predeterminada del servidor. OpenClaw solo reenvía thinking.keep para moonshot/kimi-k2.6 y lo elimina de otros modelos. Kimi K2.7 Code conserva el historial completo de razonamiento de forma predeterminada, mientras que OpenClaw omite todo el campo thinking.

json5

{  agents: {    defaults: {      models: {        "moonshot/kimi-k2.6": {          params: {            thinking: { type: "enabled", keep: "all" },          },        },      },    },  },}

Saneamiento de ids de llamadas a herramientas

Moonshot Kimi sirve ids nativos de tool_call con la forma functions.<name>:<index>. Para el transporte OpenAI-completions, OpenClaw conserva la primera aparición de cada id nativo de Kimi y reescribe los duplicados posteriores como ids deterministas de estilo OpenAI call_*. Los resultados de herramienta coincidentes se reasignan con el mismo id para que la reproducción siga siendo única sin eliminar el primer id nativo de Kimi.

Para forzar el saneamiento estricto en un proveedor personalizado compatible con OpenAI, configura sanitizeToolCallIds: true:

json5

{  models: {    providers: {      "my-kimi-proxy": {        api: "openai-completions",        sanitizeToolCallIds: true,      },    },  },}

Compatibilidad de uso en streaming

Los endpoints nativos de Moonshot (https://api.moonshot.ai/v1 y https://api.moonshot.cn/v1) anuncian compatibilidad de uso en streaming en el transporte compartido openai-completions. OpenClaw lo determina a partir de las capacidades del endpoint, por lo que los ids de proveedores personalizados compatibles que apuntan a los mismos hosts nativos de Moonshot heredan el mismo comportamiento de uso en streaming.

Con los precios de K2.6 del catálogo, el uso transmitido en streaming que incluye tokens de entrada, salida y lectura de caché también se convierte en un coste local estimado en USD para /status, /usage full, /usage cost y la contabilidad de sesiones respaldada por transcripciones.

Referencia de endpoint y referencia de modelo

Proveedor	Prefijo de referencia de modelo	Endpoint	Variable de entorno de autenticación
Moonshot	`moonshot/`	`https://api.moonshot.ai/v1`	`MOONSHOT_API_KEY`
Moonshot CN	`moonshot/`	`https://api.moonshot.cn/v1`	`MOONSHOT_API_KEY`
Kimi Coding	`kimi/`	Endpoint de Kimi Coding	`KIMI_API_KEY`
Búsqueda web	N/A	Igual que la región de la API de Moonshot	`KIMI_API_KEY` or `MOONSHOT_API_KEY`

La búsqueda web de Kimi usa KIMI_API_KEY o MOONSHOT_API_KEY, y de forma predeterminada usa https://api.moonshot.ai/v1 con el modelo kimi-k2.6.
Sobrescribe los precios y los metadatos de contexto en models.providers si es necesario.
Si Moonshot publica límites de contexto diferentes para un modelo, ajusta contextWindow según corresponda.

Relacionado

Selección de modelo

Elección de proveedores, referencias de modelo y comportamiento de conmutación por error.

Búsqueda web

Configuración de proveedores de búsqueda web, incluido Kimi.

Referencia de configuración

Esquema de configuración completo para proveedores, modelos y plugins.

Moonshot Open Platform

Gestión de claves de API de Moonshot y documentación.

Was this useful?

Moonshot AI

Catálogo de modelos integrado

Primeros pasos

Moonshot API

Choose your endpoint region

Run onboarding

Set a default model

Verify models are available

Run a live smoke test

Ejemplo de configuración

Kimi Coding

Install the plugin

Run onboarding

Set a default model

Verify the model is available

Ejemplo de configuración

Búsqueda web de Kimi

Run interactive web search setup

Configure the web search region and model

Configuración avanzada

Relacionado

On this page

Molty