Moonshot AI

Moonshot fournit l’API Kimi avec des points de terminaison compatibles avec OpenAI. Définissez le modèle par défaut sur moonshot/kimi-k2.6 pour Moonshot Open Platform, ou sur kimi/kimi-for-coding pour Kimi Coding.

Moonshot et Kimi Coding sont des fournisseurs distincts, chacun étant distribué sous forme de Plugin externe séparé. Les clés ne sont pas interchangeables, les points de terminaison diffèrent et les références de modèles diffèrent (moonshot/... contre kimi/...).

Catalogue de modèles intégré

Référence du modèle	Nom	Raisonnement	Entrée	Contexte	Sortie maximale
`moonshot/kimi-k2.6`	Kimi K2.6	Non	texte, image	262,144	262,144
`moonshot/kimi-k2.7-code`	Kimi K2.7 Code	Toujours activé	texte, image	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	Non	texte, image	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	Oui	texte	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	Oui	texte	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	Non	texte	256,000	16,384

Les estimations de coût du catalogue utilisent les tarifs à l’usage publiés par Moonshot : Kimi K2.7 Code coûte 0,19

/MTok en cas d’accès au cache, 0,95

/MTok en entrée et 4,00

/MTok en sortie ; Kimi K2.6 coûte 0,16

/MTok en cas d’accès au cache, 0,95

/MTok en entrée et 4,00

/MTok en sortie ; Kimi K2.5 coûte 0,10

/MTok en cas d’accès au cache, 0,60

/MTok en entrée et 3,00 $/MTok en sortie. Les autres entrées du catalogue conservent des valeurs temporaires à coût nul, sauf si vous les remplacez dans la configuration. Kimi K2.7 Code utilise toujours le raisonnement natif. OpenClaw expose uniquement l’état on du raisonnement pour ce modèle et omet les champs sortants thinking et reasoning_effort, comme l’exige Moonshot. Il omet également les paramètres d’échantillonnage (temperature, top_p, n, presence_penalty, frequency_penalty), que K2.7 fixe aux valeurs par défaut du fournisseur. Kimi K2.6 reste le modèle par défaut lors de la configuration initiale.

Prise en main

Moonshot et Kimi Coding sont tous deux des Plugins externes : installez-en un avant la configuration initiale.

API Moonshot
Kimi Coding

Idéal pour : les modèles Kimi K2 via Moonshot Open Platform.

Installer le Plugin

openclaw plugins install @openclaw/moonshot-provider
openclaw gateway restart

Choisir la région du point de terminaison

Choix d’authentification	Point de terminaison	Région
`moonshot-api-key`	`https://api.moonshot.ai/v1`	International
`moonshot-api-key-cn`	`https://api.moonshot.cn/v1`	Chine

Lancer la configuration initiale

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

Ou pour le point de terminaison chinois :

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

Définir un modèle par défaut

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

Vérifier que les modèles sont disponibles

openclaw models list --provider moonshot

Exécuter un test de bon fonctionnement en conditions réelles

Utilisez un répertoire d’état isolé pour vérifier l’accès au modèle et le suivi des coûts sans modifier vos sessions habituelles :

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 réponse JSON doit indiquer provider: "moonshot" et model: "kimi-k2.6". L’entrée de transcription de l’assistant enregistre l’utilisation normalisée des jetons ainsi que le coût estimé sous usage.cost lorsque Moonshot renvoie les métadonnées d’utilisation.

Exemple de configuration

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

Idéal pour : les tâches axées sur le code via le point de terminaison Kimi Coding.

Kimi Coding utilise une clé d’API et un préfixe de fournisseur (kimi/...) différents de ceux de Moonshot (moonshot/...). La référence de modèle stable est kimi/kimi-for-coding ; les anciennes références kimi/kimi-code et kimi/k2p5 restent acceptées et sont normalisées vers cet identifiant de modèle.

Installer le Plugin

openclaw plugins install @openclaw/kimi-provider
openclaw gateway restart

Lancer la configuration initiale

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

Définir un modèle par défaut

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

Vérifier que le modèle est disponible

openclaw models list --provider kimi

Exemple de configuration

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

Recherche web Kimi

Le Plugin Moonshot enregistre également Kimi comme fournisseur web_search, reposant sur la recherche web de Moonshot.

Lancer la configuration interactive de la recherche web

openclaw configure --section web

Choisissez Kimi dans la section de recherche web afin d’enregistrer plugins.entries.moonshot.config.webSearch.*.

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

La configuration interactive demande les informations suivantes :

Paramètre	Options
Région de l’API	`https://api.moonshot.ai/v1` (international) ou `https://api.moonshot.cn/v1` (Chine)
Modèle de recherche web	`kimi-k2.6` par défaut

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.6",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

Configuration avancée

Mode de raisonnement natif

Kimi K2.7 Code utilise toujours le raisonnement natif. Moonshot exige que les clients omettent le champ thinking pour ce modèle ; OpenClaw expose donc uniquement on et ignore les anciens paramètres off. K2.7 fixe également temperature, top_p, n, presence_penalty et frequency_penalty ; OpenClaw omet les valeurs de remplacement configurées pour ces champs.Les autres modèles Kimi de Moonshot prennent en charge un raisonnement natif binaire :

thinking: { type: "enabled" }
thinking: { type: "disabled" }

Configurez-le pour chaque modèle via agents.defaults.models.<provider/model>.params :

{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}

OpenClaw associe les niveaux d’exécution /think de ces modèles comme suit :

Niveau `/think`	Comportement de Moonshot
`/think off`	`thinking.type=disabled`
Tout niveau autre que désactivé	`thinking.type=enabled`

Lorsque le raisonnement Moonshot est activé, tool_choice doit être défini sur auto ou none. Un choix d’outil imposé (type: "tool" ou type: "function") ramène le raisonnement à disabled afin que l’outil demandé soit tout de même exécuté ; tool_choice: "required" est quant à lui normalisé vers auto. Cela s’applique à tous les modèles Moonshot à l’exception de Kimi K2.7 Code, dont le mode de raisonnement ne peut pas être désactivé : son tool_choice est normalisé vers auto lorsqu’il est incompatible.

Kimi K2.6 accepte également un champ facultatif thinking.keep qui contrôle la conservation de reasoning_content entre plusieurs tours. Définissez-le sur "all" pour conserver l’intégralité du raisonnement entre les tours ; omettez-le (ou laissez-le à null) pour utiliser la stratégie par défaut du serveur. OpenClaw ne transmet thinking.keep que pour moonshot/kimi-k2.6 et le supprime pour les autres modèles. Kimi K2.7 Code conserve par défaut l’historique complet du raisonnement, tandis qu’OpenClaw omet entièrement le champ thinking.

{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}

Assainissement des identifiants d’appel d’outil

Moonshot Kimi fournit des identifiants tool_call natifs au format functions.<name>:<index>. OpenClaw conserve la première occurrence de chaque identifiant Kimi natif et réécrit les doublons suivants sous forme d’identifiants call_* déterministes au format OpenAI. Les résultats d’outil correspondants sont remappés avec le même identifiant afin que la relecture reste sans doublon, sans supprimer le premier identifiant natif de Kimi. Ce comportement est intégré au fournisseur Moonshot inclus et ne constitue pas un paramètre configurable par l’utilisateur.

Compatibilité de l’utilisation en streaming

Les points de terminaison Moonshot natifs (https://api.moonshot.ai/v1 et https://api.moonshot.cn/v1) annoncent la compatibilité de l’utilisation en streaming. OpenClaw détermine celle-ci à partir de l’hôte du point de terminaison, et non de l’identifiant du fournisseur ; un identifiant de fournisseur personnalisé pointant vers le même hôte Moonshot natif hérite donc du même comportement d’utilisation en streaming.Avec la tarification K2.6 du catalogue, l’utilisation en streaming qui comprend les jetons d’entrée, de sortie et lus depuis le cache est également convertie en estimation locale du coût en USD pour /status, /usage full, /usage cost et la comptabilisation des sessions fondée sur les transcriptions.

Référence des points de terminaison et des références de modèle

Fournisseur	Préfixe de référence du modèle	Point de terminaison	Variable d’environnement d’authentification
Moonshot	`moonshot/`	`https://api.moonshot.ai/v1`	`MOONSHOT_API_KEY`
Moonshot CN	`moonshot/`	`https://api.moonshot.cn/v1`	`MOONSHOT_API_KEY`
Kimi Coding	`kimi/`	Point de terminaison Kimi Coding	`KIMI_API_KEY`
Recherche Web	S/O	Identique à la région de l’API Moonshot	`KIMI_API_KEY` ou `MOONSHOT_API_KEY`

La recherche Web Kimi utilise KIMI_API_KEY ou MOONSHOT_API_KEY et emploie par défaut https://api.moonshot.ai/v1 avec le modèle kimi-k2.6.
Remplacez si nécessaire les métadonnées de tarification et de contexte dans models.providers.
Si Moonshot publie des limites de contexte différentes pour un modèle, ajustez contextWindow en conséquence.

Contenu associé

Sélection du modèle

Choix des fournisseurs, des références de modèle et du comportement de basculement.

Recherche Web

Configuration des fournisseurs de recherche Web, notamment Kimi.

Référence de configuration

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

Plateforme ouverte Moonshot

Gestion des clés d’API Moonshot et documentation.

Overview

Concepts and configuration

Providers

Catalogue de modèles intégré

Prise en main

Exemple de configuration

Exemple de configuration

Recherche web Kimi

Configuration avancée

Contenu associé

Sélection du modèle

Recherche Web

Référence de configuration

Plateforme ouverte Moonshot

​Catalogue de modèles intégré

​Prise en main

​Exemple de configuration

​Exemple de configuration

​Recherche web Kimi

​Configuration avancée

​Contenu associé

Sélection du modèle

Recherche Web

Référence de configuration

Plateforme ouverte Moonshot

Catalogue de modèles intégré

Prise en main

Exemple de configuration

Exemple de configuration

Recherche web Kimi

Configuration avancée

Contenu associé