Passer au contenu principal

​
Moonshot AI (Kimi)

Moonshot fournit l’API Kimi avec des points de terminaison compatibles OpenAI. Configurez le fournisseur et définissez le modèle par défaut sur moonshot/kimi-k2.5, ou utilisez Kimi Coding avec kimi/kimi-code.
Moonshot et Kimi Coding sont des fournisseurs distincts. Les clés ne sont pas interchangeables, les points de terminaison diffèrent, et les références de modèles diffèrent (moonshot/... vs kimi/...).

​
Catalogue de modèles intégré

Model refNomRaisonnementEntréeContexteSortie max
moonshot/kimi-k2.5Kimi K2.5Nontext, image262,144262,144
moonshot/kimi-k2-thinkingKimi K2 ThinkingOuitext262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking TurboOuitext262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboNontext256,00016,384

​
Démarrage

Choisissez votre fournisseur et suivez les étapes de configuration.
Idéal pour : les modèles Kimi K2 via Moonshot Open Platform.
1

Choisir votre région de point de terminaison

Choix d’authentificationPoint de terminaisonRégion
moonshot-api-keyhttps://api.moonshot.ai/v1International
moonshot-api-key-cnhttps://api.moonshot.cn/v1Chine
2

Lancer l’onboarding

openclaw onboard --auth-choice moonshot-api-key
Ou pour le point de terminaison Chine :
openclaw onboard --auth-choice moonshot-api-key-cn
3

Définir un modèle par défaut

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

Vérifier que les modèles sont disponibles

openclaw models list --provider moonshot

​
Exemple de configuration

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.5" },
      models: {
        // moonshot-kimi-k2-aliases:start
        "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.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, 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
        ],
      },
    },
  },
}

​
Recherche web Kimi

OpenClaw inclut également Kimi comme fournisseur web_search, adossé à la recherche web Moonshot.
1

Lancer la configuration interactive de la recherche web

openclaw configure --section web
Choisissez Kimi dans la section de recherche web pour stocker plugins.entries.moonshot.config.webSearch.*.
2

Configurer la région de recherche web et le modèle

La configuration interactive demande :
ParamètreOptions
Région APIhttps://api.moonshot.ai/v1 (international) ou https://api.moonshot.cn/v1 (Chine)
Modèle de recherche webPar défaut : kimi-k2.5
La configuration se trouve sous 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.5",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

​
Avancé

Moonshot Kimi prend en charge un mode de réflexion natif binaire :
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
Configurez-le par modèle via agents.defaults.models.<provider/model>.params :
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.5": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
OpenClaw mappe également les niveaux d’exécution /think pour Moonshot :
Niveau /thinkComportement Moonshot
/think offthinking.type=disabled
Tout niveau non offthinking.type=enabled
Lorsque la réflexion Moonshot est activée, tool_choice doit être auto ou none. OpenClaw normalise les valeurs tool_choice incompatibles en auto pour assurer la compatibilité.
Les points de terminaison Moonshot natifs (https://api.moonshot.ai/v1 et https://api.moonshot.cn/v1) annoncent une compatibilité d’utilisation en streaming sur le transport partagé openai-completions. OpenClaw s’appuie sur les capacités du point de terminaison, de sorte que les ID de fournisseurs personnalisés compatibles ciblant les mêmes hôtes Moonshot natifs héritent du même comportement d’utilisation en streaming.
FournisseurPréfixe de référence de modèlePoint de terminaisonVariable d’environnement d’authentification
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Point de terminaison Kimi CodingKIMI_API_KEY
Recherche webN/AIdentique à la région API MoonshotKIMI_API_KEY ou MOONSHOT_API_KEY
  • La recherche web Kimi utilise KIMI_API_KEY ou MOONSHOT_API_KEY, et utilise par défaut https://api.moonshot.ai/v1 avec le modèle kimi-k2.5.
  • Remplacez les métadonnées de tarification et de contexte dans models.providers si nécessaire.
  • Si Moonshot publie des limites de contexte différentes pour un modèle, ajustez contextWindow en conséquence.

​
Liens associés

Sélection du modèle

Choisir les fournisseurs, les références de modèles et le comportement de basculement.

Recherche web

Configuration des fournisseurs de recherche web, y compris Kimi.

Référence de configuration

Schéma de configuration complet pour les fournisseurs, les modèles et les plugins.

Moonshot Open Platform

Gestion des clés API Moonshot et documentation.