--- read_when: - Quieres la configuración de Moonshot K2 (Moonshot Open Platform) frente a Kimi Coding - Debe comprender los puntos de conexión, las claves y las referencias de modelo independientes. - Quieres configuración para copiar y pegar para cualquiera de los proveedores summary: Configurar Moonshot K2 frente a Kimi Coding (proveedores y claves separados) title: Moonshot AI x-i18n: generated_at: "2026-06-27T12:39:09Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: e7365d7e843275750824a937553dcf535245146fb49fe00c622bf14b71d2dd17 source_path: providers/moonshot.md workflow: 16 --- 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`. Moonshot y Kimi Coding son **proveedores separados**. Las claves no son intercambiables, los endpoints difieren y las referencias de modelo difieren (`moonshot/...` frente a `kimi/...`). ## Catálogo de modelos integrado [//]: # "moonshot-kimi-k2-ids:start" | 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 | [//]: # "moonshot-kimi-k2-ids:end" 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. **Recomendado para:** modelos Kimi K2 mediante Moonshot Open Platform. | 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 | ```bash openclaw onboard --auth-choice moonshot-api-key ``` O para el endpoint de China: ```bash openclaw onboard --auth-choice moonshot-api-key-cn ``` ```json5 { agents: { defaults: { model: { primary: "moonshot/kimi-k2.6" }, }, }, } ``` ```bash openclaw models list --provider moonshot ``` 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 ], }, }, }, } ``` Instala el Plugin oficial y luego reinicia Gateway: ```bash openclaw plugins install @openclaw/kimi-provider openclaw gateway restart ``` **Recomendado para:** tareas enfocadas en código mediante el endpoint de Kimi Coding. Kimi Coding usa una clave de API y un prefijo de proveedor (`kimi/...`) distintos a los de Moonshot (`moonshot/...`). La referencia de modelo estable de la API es `kimi/kimi-for-coding`; las referencias heredadas `kimi/kimi-code` y `kimi/k2p5` siguen aceptándose y se normalizan a ese ID de modelo de API. ```bash openclaw plugins install @openclaw/kimi-provider ``` ```bash openclaw onboard --auth-choice kimi-code-api-key ``` ```json5 { agents: { defaults: { model: { primary: "kimi/kimi-for-coding" }, }, }, } ``` ```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. ```bash openclaw configure --section web ``` Elige **Kimi** en la sección de búsqueda web para almacenar `plugins.entries.moonshot.config.webSearch.*`. 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 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..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` | Cuando el pensamiento de Moonshot está habilitado, `tool_choice` debe ser `auto` o `none`. OpenClaw normaliza los valores incompatibles a `auto`. Esto incluye Kimi K2.7 Code, cuyo modo de pensamiento no puede deshabilitarse para preservar una elección de herramienta fijada. 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" }, }, }, }, }, }, } ``` Moonshot Kimi sirve ids nativos de tool_call con la forma `functions.:`. 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, }, }, }, } ``` 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. | 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 Elección de proveedores, referencias de modelo y comportamiento de conmutación por error. Configuración de proveedores de búsqueda web, incluido Kimi. Esquema de configuración completo para proveedores, modelos y plugins. Gestión de claves de API de Moonshot y documentación.