OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Moonshot AI

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.

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

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.

API de Moonshot

Recomendado para: modelos Kimi K2 mediante Moonshot Open Platform.

  • Instalar el plugin

    bash
    openclaw plugins install @openclaw/moonshot-provideropenclaw 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

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

    O para el endpoint de China:

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

  • Establecer un modelo predeterminado

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

  • Verificar que los modelos estén disponibles

    bash
    openclaw models list --provider moonshot

  • Ejecutar una prueba de humo en vivo

    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        ],      },    },  },}

    Kimi Coding

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

  • Instalar el plugin

    bash
    openclaw plugins install @openclaw/kimi-provideropenclaw gateway restart

  • Ejecutar la incorporación

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

  • Establecer un modelo predeterminado

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

  • Verificar que el modelo esté disponible

    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.

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

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

    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

    Modo de razonamiento nativo

    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.<provider/model>.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

    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" },          },        },      },    },  },}
    Saneamiento del id de llamada a herramientas

    Moonshot Kimi proporciona ids nativos de tool_call con el formato functions.<name>:<index>. 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.

    Compatibilidad del uso en streaming

    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.

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

    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 de claves de API y documentación de Moonshot.
    Was this useful?
    On this page

    On this page