Providers
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.
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
Más adecuado para: los modelos Kimi K3 y K2 mediante Moonshot Open Platform.
Instalar el plugin
openclaw plugins install @openclaw/moonshot-provideropenclaw gateway restartElegir 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-keyO bien, para el endpoint de China:
openclaw onboard --auth-choice moonshot-api-key-cnEstablecer 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-k3Verificar que los modelos estén disponibles
openclaw models list --provider moonshotEjecutar 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 \ --jsonLa 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 ], }, }, },}Kimi Coding
Más adecuado para: tareas centradas en código mediante el endpoint de Kimi 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-provideropenclaw gateway restartEjecutar la incorporación
openclaw onboard --auth-choice kimi-code-api-keyEstablecer un modelo predeterminado
{ agents: { defaults: { model: { primary: "kimi/kimi-for-coding" }, }, },}Verificar que el modelo esté disponible
openclaw models list --provider kimiKimi 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 webElija 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 |
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_KEYoMOONSHOT_API_KEY, y de forma predeterminada utilizahttps://api.moonshot.ai/v1con el modelokimi-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
contextWindowen consecuencia.
Contenido 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 y documentación de claves de la API de Moonshot.