Configura Moonshot AI (Kimi) en minutos

Seguro que ya estás cansado de configurar APIs que prometen mucho y luego fallan al manejar contextos largos. Yo pasé horas peleando con límites de tokens hasta que probé Kimi. Si buscas una alternativa que maneje archivos pesados sin que tu presupuesto sufra, esta es la opción que te recomiendo.

Lo mejor de Moonshot es que su API es compatible con los endpoints de OpenAI. Esto significa que puedes integrarlo en tu flujo actual casi sin cambiar nada en tu código.

Requisitos previos

1. Una API key activa de Moonshot AI o Kimi Coding.
2. Node.js instalado en tu entorno local.

Inicio rápido

Para empezar rápido, usa el comando de configuración automática. Solo tienes que elegir el proveedor adecuado según la llave que tengas.

Para Moonshot estándar:

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

Si vas a usar Kimi Coding para programar:

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

Ten en cuenta que Moonshot y Kimi Coding funcionan como proveedores distintos. Las llaves no se pueden intercambiar, los endpoints son diferentes y los prefijos de los modelos también cambian (moonshot/ vs kimi-coding/).

Configuración manual (Moonshot API)

Si prefieres editar tu archivo de configuración, aquí tienes el snippet necesario. Te recomiendo usar kimi-k2.5 como modelo principal por su equilibrio entre velocidad y calidad.

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.5" },
      models: {
        "moonshot/kimi-k2.5": { alias: "Kimi K2.5" },
        "moonshot/kimi-k2-0905-preview": { alias: "Kimi K2" },
        "moonshot/kimi-k2-turbo-preview": { alias: "Kimi K2 Turbo" },
        "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "kimi-k2.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 8192,
          },
          {
            id: "kimi-k2-0905-preview",
            name: "Kimi K2 0905 Preview",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 8192,
          },
          {
            id: "kimi-k2-turbo-preview",
            name: "Kimi K2 Turbo",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 8192,
          },
          {
            id: "kimi-k2-thinking",
            name: "Kimi K2 Thinking",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

Configuración para Kimi Coding

Si tu enfoque es el desarrollo de software, usa esta estructura simplificada:

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "kimi-coding/k2p5" },
      models: {
        "kimi-coding/k2p5": { alias: "Kimi K2.5" },
      },
    },
  },
}

Solución de problemas

Si algo no sale como esperabas, revisa estos dos puntos:

1. Error de autenticación: Verifica que no estés mezclando las llaves. Una API key de Moonshot no activará los modelos de kimi-coding.
2. Latencia o bloqueos: Si estás trabajando desde China, cambia el baseUrl a https://api.moonshot.cn/v1. Para el resto del mundo, usa el endpoint .ai.

¿Necesitas ayuda con otros proveedores o configuraciones avanzadas? Pregunta a nuestro AI Setup Assistant.

Próximos pasos

• Configuración de variables de entorno
• Uso de modelos con Reasoning
• Optimización de costos en la API
• Guía de Kimi Coding avanzado