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

Catálogo de modelos integrado

Referencia de modelo	Nombre	Razonamiento	Entrada	Contexto	Salida máx.
`moonshot/kimi-k2.6`	Kimi K2.6	No	text, image	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	No	text, image	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	Sí	text	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	Sí	text	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	No	text	256,000	16,384

Las estimaciones de costo incluidas para los modelos K2 actualmente alojados por Moonshot usan las tarifas publicadas de pago por uso de Moonshot: Kimi K2.6 cuesta $0.16/MTok en aciertos de caché, $0.95/MTok de entrada y $4.00/MTok de salida; Kimi K2.5 cuesta $0.10/MTok en aciertos de caché, $0.60/MTok de entrada y $3.00/MTok de salida. Otras entradas heredadas del catálogo mantienen marcadores de costo cero a menos que los sobrescribas en la configuración.

Primeros pasos

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

Moonshot API

Ideal para: modelos Kimi K2 mediante la Moonshot Open Platform.

Elige la región de tu 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

Ejecuta el onboarding

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

O para el endpoint de China:

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

Establece un modelo predeterminado

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

Verifica que los modelos estén disponibles

openclaw models list --provider moonshot

Ejecuta una prueba smoke 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 informar provider: "moonshot" y model: "kimi-k2.6". La entrada de transcripción del asistente almacena el uso de tokens normalizado junto con el costo 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-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
        ],
      },
    },
  },
}

Kimi Coding

Ideal para: tareas centradas en código mediante el endpoint de Kimi Coding.

Ejecuta el onboarding

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

Establece un modelo predeterminado

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

Verifica 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-code" },
      models: {
        "kimi/kimi-code": { alias: "Kimi" },
      },
    },
  },
}

Búsqueda web de Kimi

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

Ejecuta la configuración interactiva de búsqueda web

openclaw configure --section web

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

Configura 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	Usa `kimi-k2.6` por defecto

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

{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // o usa 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 razonamiento nativo

Moonshot Kimi admite razonamiento nativo binario:

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

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

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

OpenClaw también mapea 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 off	`thinking.type=enabled`

Kimi K2.6 también acepta un campo opcional thinking.keep que controla la retención de reasoning_content en varios turnos. Establécelo en "all" para conservar todo el razonamiento 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.

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

Saneamiento de IDs de llamadas a herramientas

Moonshot Kimi sirve IDs de tool_call con la forma functions.<name>:<index>. OpenClaw los conserva sin cambios para que las llamadas a herramientas de varios turnos sigan funcionando.

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

{
  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 sobre el transporte compartido openai-completions. OpenClaw basa esto en las capacidades del endpoint, por lo que los IDs de proveedor personalizados compatibles que apunten a los mismos hosts nativos de Moonshot heredan el mismo comportamiento de uso en streaming.

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

Referencia de endpoints y referencias 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` o `MOONSHOT_API_KEY`

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

Relacionado

Selección de modelo

Elegir proveedores, referencias de modelo y comportamiento de failover.

Búsqueda web

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

Referencia de configuración

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

Moonshot Open Platform

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

# Catálogo de modelos integrado

# Primeros pasos

Moonshot API

Elige la región de tu endpoint

Ejecuta el onboarding

Establece un modelo predeterminado

Verifica que los modelos estén disponibles

Ejecuta una prueba smoke en vivo

# Ejemplo de configuración

Kimi Coding

Ejecuta el onboarding

Establece un modelo predeterminado

Verifica que el modelo esté disponible

# Ejemplo de configuración

# Búsqueda web de Kimi

Ejecuta la configuración interactiva de búsqueda web

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

# Configuración avanzada

# Relacionado

Catálogo de modelos integrado

Primeros pasos

Ejemplo de configuración

Ejemplo de configuración

Búsqueda web de Kimi

Configuración avanzada

Relacionado