---
read_when:
- Quieres configurar Moonshot K2 (Moonshot Open Platform) o Kimi Coding
- Debes comprender los endpoints, las claves y las referencias de modelos por separado
- Quieres una configuración lista 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-07-11T23:29:58Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: c917a595337fc2138601245f4c7055815859dfa3b2ddf90a56c980a7a4e09744
source_path: providers/moonshot.md
workflow: 16
---
Moonshot proporciona la API de Kimi con endpoints compatibles con OpenAI. Establezca el
modelo predeterminado en `moonshot/kimi-k2.6` para Moonshot Open Platform, o en
`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 también (`moonshot/...` frente a `kimi/...`).
## Catálogo de modelos integrado
[//]: # "moonshot-kimi-k2-ids:start"
| 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-k2.7-code` | Kimi K2.7 Code | Siempre activado | 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 costos del catálogo utilizan las tarifas de pago por uso publicadas por 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. Las demás entradas
del catálogo mantienen marcadores de costo cero, salvo que los sobrescriba en la configuración.
Kimi K2.7 Code siempre utiliza razonamiento nativo. OpenClaw solo expone el estado de razonamiento `on`
para este modelo y omite los campos salientes `thinking` y
`reasoning_effort`, según exige Moonshot. También omite las
sobrescrituras de muestreo (`temperature`, `top_p`, `n`, `presence_penalty`,
`frequency_penalty`), que K2.7 fija en los valores predeterminados del proveedor. Kimi K2.6 sigue siendo
el modelo predeterminado durante la incorporación.
## Primeros pasos
Tanto Moonshot como Kimi Coding son plugins externos; instale uno antes de
iniciar la incorporación.
**Recomendado para:** modelos Kimi K2 mediante Moonshot Open Platform.
```bash
openclaw plugins install @openclaw/moonshot-provider
openclaw gateway restart
```
| 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
```
Utilice un directorio de estado aislado cuando quiera verificar el acceso al modelo y el seguimiento
de costos sin afectar sus sesiones habituales:
```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 indicar `provider: "moonshot"` y
`model: "kimi-k2.6"`. La entrada de la transcripción del asistente almacena
el uso normalizado de tokens y 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
],
},
},
},
}
```
**Recomendado 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/...`). La referencia de modelo estable es `kimi/kimi-for-coding`; las referencias heredadas `kimi/kimi-code` y `kimi/k2p5` siguen aceptándose y se normalizan a ese identificador de modelo.
```bash
openclaw plugins install @openclaw/kimi-provider
openclaw gateway restart
```
```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
```
Elija **Kimi** en la sección de búsqueda web para almacenar
`plugins.entries.moonshot.config.webSearch.*`.
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`:
```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 utiliza razonamiento nativo. Moonshot exige que los clientes
omitan el campo `thinking` para este modelo, por lo que OpenClaw solo expone `on` e
ignora los ajustes `off` obsoletos. K2.7 también fija `temperature`, `top_p`, `n`,
`presence_penalty` y `frequency_penalty`; OpenClaw omite las
sobrescrituras configuradas para esos campos.
Los demás modelos Kimi de Moonshot admiten razonamiento nativo binario:
- `thinking: { type: "enabled" }`
- `thinking: { type: "disabled" }`
Configúrelo 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 salvo off | `thinking.type=enabled` |
Cuando el razonamiento de Moonshot está activado, `tool_choice` debe ser `auto` o `none`. Una selección de herramienta fijada (`type: "tool"` o `type: "function"`) fuerza en su lugar que el razonamiento vuelva a `disabled`, para que la herramienta solicitada pueda ejecutarse; `tool_choice: "required"` se normaliza en su lugar a `auto`. Esto se aplica a todos los modelos de Moonshot excepto Kimi K2.7 Code, cuyo modo de razonamiento no puede desactivarse; su `tool_choice` se normaliza a `auto` cuando es incompatible.
Kimi K2.6 también acepta un campo opcional `thinking.keep` que controla
la conservación de `reasoning_content` entre varios turnos. Establézcalo en `"all"` para conservar
el razonamiento completo entre turnos; omítalo (o déjelo como `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 de forma predeterminada el historial completo de razonamiento, mientras que OpenClaw omite por completo
el campo `thinking`.
```json5
{
agents: {
defaults: {
models: {
"moonshot/kimi-k2.6": {
params: {
thinking: { type: "enabled", keep: "all" },
},
},
},
},
},
}
```
Moonshot Kimi proporciona ids nativos de tool_call con el formato `functions.:`. OpenClaw conserva la primera aparición de cada id nativo de Kimi y reescribe los duplicados posteriores como ids `call_*` deterministas al estilo de OpenAI. Los resultados de herramientas correspondientes se reasignan con el mismo id para que la reproducción siga siendo única sin eliminar el primer id nativo de Kimi. Este comportamiento está integrado en el proveedor Moonshot incluido y no es un ajuste configurable por el usuario.
Los endpoints nativos de Moonshot (`https://api.moonshot.ai/v1` y
`https://api.moonshot.cn/v1`) indican compatibilidad con el uso en streaming.
OpenClaw determina esto a partir del host del endpoint, no del id del proveedor, por lo que un id 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 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
basada en transcripciones.
| 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 | N/D | La misma región que 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, de forma predeterminada, utiliza `https://api.moonshot.ai/v1` con el modelo `kimi-k2.6`.
- Sobrescriba los precios y los metadatos de contexto en `models.providers` si es necesario.
- Si Moonshot publica límites de contexto distintos para un modelo, ajuste `contextWindow` en consecuencia.
## Relacionado
Elección de proveedores, referencias de modelos 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 y documentación de Moonshot.