Moonshot AI

Moonshot proporciona la API de Kimi con endpoints compatibles con OpenAI. Seleccione moonshot/kimi-k3 para Kimi K3, mantenga el valor predeterminado de incorporación moonshot/kimi-k2.6 o use kimi/kimi-for-coding para Kimi Coding.

Moonshot y Kimi Coding son proveedores independientes, cada uno distribuido como un plugin externo distinto. Las claves no son intercambiables, los endpoints son diferentes y las referencias de modelo difieren (moonshot/... frente a kimi/...).

Catálogo de modelos integrado

Referencia del modelo	Nombre	Razonamiento	Entrada	Contexto	Salida máxima
`moonshot/kimi-k2.6`	Kimi K2.6	No	texto, imagen	262,144	262,144
`moonshot/kimi-k3`	Kimi K3	Siempre al máximo	texto, imagen	1,048,576	1,048,576
`moonshot/kimi-k2.7-code`	Kimi K2.7 Code	Siempre activado	texto, imagen	262,144	262,144
`moonshot/kimi-k2.7-code-highspeed`	Kimi K2.7 Code HighSpeed	Siempre activado	texto, imagen	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	No	texto, imagen	262,144	262,144

Las estimaciones de costes del catálogo utilizan las tarifas de pago por uso publicadas por Moonshot. Consulte las páginas vigentes del proveedor sobre Kimi K3, Kimi K2.7 Code, Kimi K2.6 y Kimi K2.5 antes de tomar decisiones sobre costes. Kimi K3 siempre razona con reasoning_effort: "max". OpenClaw solo expone /think max, omite el campo exclusivo de K2 thinking y elimina las modificaciones de muestreo (temperature, top_p, n, presence_penalty y frequency_penalty) que K3 fija en los valores predeterminados del proveedor. Kimi K2.7 Code también utiliza siempre el pensamiento nativo, pero exige que se omitan tanto thinking como reasoning_effort; la variante HighSpeed utiliza el mismo contrato. Kimi K2.6 sigue siendo el valor predeterminado de incorporación. Consulte la guía de inicio rápido de Kimi K3 de Moonshot.

Primeros pasos

Tanto Moonshot como Kimi Coding son plugins externos: instale uno antes de iniciar la incorporación.

API de Moonshot
Kimi Coding

Más adecuado para: los modelos Kimi K3 y K2 mediante Moonshot Open Platform.

Instalar el plugin

openclaw plugins install @openclaw/moonshot-provider
openclaw gateway restart

Elegir la región del endpoint

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

Ejecutar la incorporación

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

O bien, para el endpoint de China:

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

Establecer Kimi K3 como modelo predeterminado

La incorporación mantiene Kimi K2.6 como valor predeterminado inicial. Cambie explícitamente cuando quiera usar Kimi K3:

openclaw models set moonshot/kimi-k3

Verificar que los modelos estén disponibles

openclaw models list --provider moonshot

Ejecutar una prueba rápida en vivo

Use un directorio de estado aislado cuando quiera verificar el acceso al modelo y el seguimiento de costes sin modificar sus sesiones habituales:

OPENCLAW_CONFIG_PATH=/tmp/openclaw-kimi/openclaw.json \
OPENCLAW_STATE_DIR=/tmp/openclaw-kimi \
openclaw agent --local \
  --session-id live-kimi-cost \
  --message 'Responde exactamente: KIMI_LIVE_OK' \
  --thinking max \
  --json

La respuesta JSON debe informar de provider: "moonshot" y model: "kimi-k3". La entrada de la transcripción del asistente almacena el uso normalizado de tokens y el coste estimado en usage.cost cuando Moonshot devuelve metadatos de uso.

Ejemplo de configuración

{
  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-k3": { alias: "Kimi K3" },
        "moonshot/kimi-k2.7-code": { alias: "Kimi K2.7 Code" },
        "moonshot/kimi-k2.7-code-highspeed": { alias: "Kimi K2.7 Code HighSpeed" },
        "moonshot/kimi-k2.5": { alias: "Kimi K2.5" },
        // 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-k3",
            name: "Kimi K3",
            reasoning: true,
            thinkingLevelMap: {
              off: null,
              minimal: null,
              low: null,
              medium: null,
              high: null,
              xhigh: "max",
              max: "max",
            },
            input: ["text", "image"],
            cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 0 },
            contextWindow: 1048576,
            maxTokens: 1048576,
          },
          {
            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.7-code-highspeed",
            name: "Kimi K2.7 Code HighSpeed",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 1.9, output: 8, cacheRead: 0.38, 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,
          },
          // moonshot-kimi-k2-models:end
        ],
      },
    },
  },
}

Más adecuado para: tareas centradas en código mediante el endpoint de Kimi Coding.

Kimi Coding utiliza una clave de API y un prefijo de proveedor (kimi/...) distintos de los de Moonshot (moonshot/...). Las referencias actuales son kimi/k3 para un contexto de 256K, kimi/k3[1m] para el nivel de 1M, kimi/kimi-for-coding y kimi/kimi-for-coding-highspeed. Las referencias heredadas kimi/kimi-code y kimi/k2p5 siguen aceptándose y se normalizan como kimi/kimi-for-coding.

El servicio de programación admite clientes compatibles tanto con https://api.kimi.com/coding/v1 de OpenAI como con https://api.kimi.com/coding/ de Anthropic. Este plugin utiliza Anthropic Messages. Cree claves de membresía en Kimi Code Console; los precios actuales de las membresías se encuentran en la página de precios de Kimi.

Instalar el plugin

openclaw plugins install @openclaw/kimi-provider
openclaw gateway restart

Ejecutar la incorporación

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

Establecer un modelo predeterminado

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

Verificar que el modelo esté disponible

openclaw models list --provider kimi

Kimi Code K3 utiliza de forma predeterminada el pensamiento profundo con max. /think off envía thinking.type: "disabled"; /think max envía la solicitud de pensamiento adaptativo de K3 con el máximo esfuerzo. Los niveles de pensamiento inferiores obsoletos se resuelven en el nivel compatible max. El modelo de 1M requiere una membresía Kimi Allegretto o superior; use kimi/k3 con Moderato.Consulte la tabla oficial de modelos de Kimi Code para conocer la disponibilidad actual por plan.

Ejemplo de configuración

{
  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.

Ejecutar la configuración interactiva de la búsqueda web

openclaw configure --section web

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

Configurar la región y el modelo de búsqueda web

La configuración interactiva solicita:

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

La configuración se encuentra en 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",
      },
    },
  },
}

Configuración avanzada

Modo de pensamiento nativo

Kimi K3 de la API de Moonshot siempre razona con el máximo esfuerzo. OpenClaw solo expone /think max, envía reasoning_effort: "max" e ignora los ajustes inferiores obsoletos o off.Kimi Code K3 expone /think off|max. Su endpoint compatible con Anthropic recibe thinking.type: "disabled" para desactivarlo, o pensamiento adaptativo con output_config.effort: "max" para el máximo. Esto se aplica tanto a kimi/k3 como a kimi/k3[1m]. La API K3 de Moonshot admite auto, none, required y selecciones de herramientas fijadas, por lo que OpenClaw conserva el tool_choice solicitado. Para el uso de herramientas en varios turnos, OpenClaw conserva el contenido de razonamiento del asistente requerido por el contrato de reproducción de Moonshot.Kimi K2.7 Code siempre utiliza pensamiento nativo. Moonshot exige que los clientes omitan el campo thinking para este modelo, por lo que OpenClaw solo expone on e ignora la configuración obsoleta de off. 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úrelo por modelo mediante agents.defaults.models.<provider/model>.params:

{
  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 distinto de desactivado	`thinking.type=enabled`

Cuando el pensamiento de Moonshot K2 está activado, tool_choice debe ser auto o none. Una selección de herramienta fijada (type: "tool" o type: "function") fuerza el pensamiento de vuelta a disabled, para que la herramienta solicitada siga ejecutándose; en cambio, tool_choice: "required" se normaliza a auto. Kimi K2.7 Code no puede desactivar el pensamiento, por lo que su tool_choice incompatible se normaliza a auto. Kimi K3 utiliza su contrato independiente de esfuerzo de razonamiento y conserva las selecciones de herramientas compatibles.

Kimi K2.6 también acepta un campo opcional thinking.keep que controla la retención de reasoning_content en varios turnos. Establézcalo en "all" para conservar el razonamiento completo entre turnos; omítalo (o déjelo en null) para utilizar 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 de forma predeterminada el historial de razonamiento completo, mientras que OpenClaw omite por completo el campo thinking.

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

Saneamiento de identificadores de llamadas a herramientas

Moonshot Kimi proporciona identificadores nativos de tool_call con el formato functions.<name>:<index>. OpenClaw conserva la primera aparición de cada identificador nativo de Kimi y reescribe los duplicados posteriores como identificadores deterministas de estilo OpenAI call_*. Los resultados de herramientas correspondientes se reasignan con el mismo identificador, de modo que la reproducción siga siendo única sin eliminar el primer identificador nativo de Kimi. Este comportamiento está integrado en el proveedor Moonshot incluido y no es una opción configurable por el usuario.

Compatibilidad del uso en streaming

Los endpoints nativos de Moonshot (https://api.moonshot.ai/v1 y https://api.moonshot.cn/v1) anuncian compatibilidad con el uso en streaming. OpenClaw determina este comportamiento mediante el host del endpoint, no mediante el identificador del proveedor, por lo que un identificador de proveedor personalizado que apunte al mismo host nativo de Moonshot hereda el mismo comportamiento de uso en streaming.Con los precios de K2.6 del catálogo, el uso transmitido que incluye tokens de entrada, salida y lectura de caché también se convierte en un coste estimado local en USD para /status, /usage full, /usage cost y la contabilización de sesiones respaldada por transcripciones.

Referencia de endpoints y referencias de modelos

Proveedor	Prefijo de referencia del 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	No aplicable	Igual que la región de la API de Moonshot	`KIMI_API_KEY` o `MOONSHOT_API_KEY`

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

Contenido relacionado

Selección de modelos

Elección de proveedores, referencias de modelos 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.

Plataforma abierta de Moonshot

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

Overview

Concepts and configuration

Providers

Catálogo de modelos integrado

Primeros pasos

Ejemplo de configuración

Ejemplo de configuración

Búsqueda web de Kimi

Configuración avanzada

Contenido relacionado

Selección de modelos

Búsqueda web

Referencia de configuración

Plataforma abierta de Moonshot

​Catálogo de modelos integrado

​Primeros pasos

​Ejemplo de configuración

​Ejemplo de configuración

​Búsqueda web de Kimi

​Configuración avanzada

​Contenido relacionado

Selección de modelos

Búsqueda web

Referencia de configuración

Plataforma abierta de Moonshot

Catálogo de modelos integrado

Primeros pasos

Ejemplo de configuración

Ejemplo de configuración

Búsqueda web de Kimi

Configuración avanzada

Contenido relacionado