Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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-for-coding.
Moonshot y Kimi Coding son proveedores independientes. Las claves no son intercambiables, los endpoints son distintos y las refs de modelo difieren (moonshot/... frente a kimi/...).

​
Catálogo de modelos integrado

Ref de modeloNombreRazonamientoEntradaContextoSalida máx.
moonshot/kimi-k2.6Kimi K2.6Notexto, imagen262,144262,144
moonshot/kimi-k2.5Kimi K2.5Notexto, imagen262,144262,144
moonshot/kimi-k2-thinkingKimi K2 ThinkingSítexto262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking TurboSítexto262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboNotexto256,00016,384
Las estimaciones de costo incluidas para los modelos K2 actuales alojados en Moonshot usan las tarifas publicadas de pago por uso de Moonshot: Kimi K2.6 cuesta 0.16/MTokporaciertodecacheˊ,0.16/MTok por acierto de caché, 0.95/MTok de entrada y 4.00/MTokdesalida;KimiK2.5cuesta4.00/MTok de salida; Kimi K2.5 cuesta 0.10/MTok por acierto de caché, 0.60/MTokdeentraday0.60/MTok de entrada y 3.00/MTok de salida. Otras entradas heredadas del catálogo mantienen marcadores de posición de costo cero salvo que los sobrescribas en la configuración.

​
Primeros pasos

Elige tu proveedor y sigue los pasos de configuración.
Ideal para: modelos Kimi K2 mediante Moonshot Open Platform.
1

Elige la región de tu endpoint

Opción de autenticaciónEndpointRegión
moonshot-api-keyhttps://api.moonshot.ai/v1Internacional
moonshot-api-key-cnhttps://api.moonshot.cn/v1China
2

Ejecuta la incorporación

openclaw onboard --auth-choice moonshot-api-key
O para el endpoint de China:
openclaw onboard --auth-choice moonshot-api-key-cn
3

Establece un modelo predeterminado

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

Verifica que los modelos estén disponibles

openclaw models list --provider moonshot
5

Ejecuta una prueba rápida 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 la transcripción del asistente almacena el uso de tokens normalizado más 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
        ],
      },
    },
  },
}

​
Búsqueda web de Kimi

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

Run interactive web search setup

openclaw configure --section web
Elige Kimi en la sección de búsqueda web para almacenar plugins.entries.moonshot.config.webSearch.*.
2

Configure the web search region and model

La configuración interactiva solicita:
ConfiguraciónOpciones
Región de APIhttps://api.moonshot.ai/v1 (internacional) o https://api.moonshot.cn/v1 (China)
Modelo de búsqueda webPredeterminado en 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

Moonshot Kimi admite el modo de pensamiento 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 asigna niveles /think en tiempo de ejecución para Moonshot:
nivel de /thinkcomportamiento de Moonshot
/think offthinking.type=disabled
Cualquier nivel que no sea offthinking.type=enabled
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 mantener la compatibilidad.
Kimi K2.6 también acepta un campo opcional thinking.keep que controla la retención de varios turnos de reasoning_content. Configúralo como "all" para conservar el razonamiento completo entre turnos; omítelo (o déjalo 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.
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
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, configura sanitizeToolCallIds: true:
{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}
Los endpoints nativos de Moonshot (https://api.moonshot.ai/v1 y https://api.moonshot.cn/v1) anuncian compatibilidad de uso en streaming en el transporte compartido openai-completions. OpenClaw determina eso a partir de las capacidades del endpoint, por lo que los ids de proveedores personalizados compatibles que apuntan a los mismos hosts nativos de Moonshot heredan el mismo comportamiento de uso en streaming.Con los precios incluidos 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.
ProveedorPrefijo de referencia de modeloPunto de conexiónVariable de entorno de autenticación
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Punto de conexión de Kimi CodingKIMI_API_KEY
Búsqueda webN/DIgual que la región de la API de MoonshotKIMI_API_KEY o MOONSHOT_API_KEY
  • La búsqueda web de Kimi usa KIMI_API_KEY o MOONSHOT_API_KEY, y de forma predeterminada usa https://api.moonshot.ai/v1 con el modelo kimi-k2.6.
  • Sobrescribe los precios y los metadatos de contexto en models.providers si es necesario.
  • Si Moonshot publica límites de contexto distintos para un modelo, ajusta contextWindow según corresponda.

​
Relacionado

Selección de modelo

Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.

Búsqueda web

Configurar proveedores de búsqueda web, incluido Kimi.

Referencia de configuración

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

Moonshot Open Platform

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