Moonshot AI

Moonshot proporciona la API de Kimi con puntos de conexión compatibles con OpenAI. Configure el proveedor y establezca el modelo predeterminado en moonshot/kimi-k2.6, o use Kimi Coding con kimi/kimi-for-coding.

Warning

Moonshot y Kimi Coding son

proveedores independientes

. Las claves no son intercambiables, los puntos de conexión difieren y las referencias de los modelos difieren (

moonshot/...

vs

kimi/...

).

Catálogo de modelos integrados

Ref. 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.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 costos incluidas para los modelos K2 alojados actualmente por Moonshot utilizan las tarifas publicadas de pago por uso de Moonshot: Kimi K2.6 es $0.16/MTok con acierto en caché, $0.95/MTok de entrada y $4.00/MTok de salida; Kimi K2.5 es $0.10/MTok con acierto en caché, $0.60/MTok de entrada y $3.00/MTok de salida. Otras entradas de catálogo heredadas mantienen marcadores de posición de costo cero a menos que las anule en la configuración.

Introducción

Elija su proveedor y siga los pasos de configuración.

API de MoonshotKimi Coding

Lo mejor para: Modelos Kimi K2 a través de la Plataforma Abierta de Moonshot.

1. Elegir tu región de punto de conexión

   Elección de autenticación	Punto de conexión	Región
   moonshot-api-key	https://api.moonshot.ai/v1	Internacional
   moonshot-api-key-cn	https://api.moonshot.cn/v1	China

2. Ejecutar la incorporación

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

   O para el punto de conexión de China:

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

3. Establecer un modelo predeterminado

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

4. Verificar que los modelos estén disponibles

   openclaw models list --provider moonshot

5. Ejecutar una prueba de humo en vivo

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

   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 debe reportar provider: "moonshot" y model: "kimi-k2.6". La entrada de la transcripción del asistente almacena el uso de tokens normalizado más el costo estimado bajo 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-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.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
        ],
      },
    },
  },
}

Mejor para: tareas centradas en el código a través del punto de conexión Kimi Coding.

Note

Kimi Coding usa una clave de API y un prefijo de proveedor diferentes (kimi/...) que Moonshot (moonshot/...). La referencia del modelo API estable es kimi/kimi-for-coding; las referencias heredadas kimi/kimi-code y kimi/k2p5 siguen siendo aceptadas y se normalizan a ese ID de modelo API.

1. Ejecutar la incorporación

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

2. Establecer un modelo predeterminado

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

3. Verificar que el modelo esté disponible

   openclaw models list --provider kimi

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

OpenClaw también incluye Kimi como un proveedor web_search, respaldado por la búsqueda web de Moonshot.

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

   openclaw configure --section web

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

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

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

Moonshot Kimi admite el pensamiento nativo binario:

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

Configúrelo por modelo a través de `agents.defaults.models.

.params`:

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

OpenClaw también asigna los niveles de `/think` en tiempo de ejecución para Moonshot:

| Nivel de `/think`       | Comportamiento de Moonshot          |
| -------------------- | -------------------------- |
| `/think off`         | `thinking.type=disabled`   |
| Cualquier nivel distinto de apagado    | `thinking.type=enabled`    |

Warning

Cuando el pensamiento de Moonshot está habilitado, tool_choice debe ser auto o none. OpenClaw normaliza los valores incompatibles de tool_choice a auto para compatibilidad.

Kimi K2.6 también acepta un campo opcional thinking.keep que controla la retención de varios turnos de reasoning_content. Establézcalo en "all" para mantener el razonamiento completo entre turnos; omítalo (o déjelo 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.

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

Saneamiento de id de llamada de herramienta

Moonshot Kimi sirve ids de tool_call con forma como `functions.

:

`. OpenClaw los conserva sin cambios para que las llamadas a herramientas de varios turnos sigan funcionando.

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

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

Compatibilidad del uso de transmisión

Los puntos de conexión nativos de Moonshot (https://api.moonshot.ai/v1 y https://api.moonshot.cn/v1) anuncian compatibilidad de uso de transmisión en el transporte compartido openai-completions. Las claves de OpenClaw desactivan las capacidades del punto de conexión, por lo que los ids de proveedores personalizados compatibles que apuntan a los mismos hosts nativos de Moonshot heredan el mismo comportamiento de uso de transmisión.

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

Referencia de punto de conexión y modelo

Proveedor	Prefijo de referencia del modelo	Punto de conexión	Var. entorno de auth
Moonshot	moonshot/	https://api.moonshot.ai/v1	MOONSHOT_API_KEY
Moonshot CN	moonshot/	https://api.moonshot.cn/v1	MOONSHOT_API_KEY
Kimi Coding	kimi/	Kimi Coding endpoint	KIMI_API_KEY
Búsqueda web	N/A	Igual que la región de la API de Moonshot	KIMI_API_KEY o MOONSHOT_API_KEY

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

Relacionado

Selección de modelo

Elegir 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 complementos.

Plataforma abierta Moonshot

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