Providers

Moonshot AI

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.6, ou utilisez Kimi Coding avec kimi/kimi-code.

Catalogue de modèles intégré

Model ref	Name	Reasoning	Input	Context	Max output
`moonshot/kimi-k2.6`	Kimi K2.6	No	text, image	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	No	text, image	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	Yes	text	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	Yes	text	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	No	text	256,000	16,384

Les estimations de coût intégrées pour les modèles K2 actuellement hébergés par Moonshot utilisent les tarifs à l’usage publiés par Moonshot : Kimi K2.6 coûte 0,16 $/MTok en lecture de cache, 0,95 $/MTok en entrée et 4,00 $/MTok en sortie ; Kimi K2.5 coûte 0,10 $/MTok en lecture de cache, 0,60 $/MTok en entrée et 3,00 $/MTok en sortie. Les autres entrées héritées du catalogue conservent des valeurs fictives à coût nul, sauf si vous les remplacez dans la configuration.

Premiers pas

Choisissez votre fournisseur et suivez les étapes de configuration.

API Moonshot

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

Choisir votre région de point de terminaison

Auth choice	Endpoint	Region
`moonshot-api-key`	`https://api.moonshot.ai/v1`	International
`moonshot-api-key-cn`	`https://api.moonshot.cn/v1`	China

Exécuter l’onboarding

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

Ou pour le point de terminaison Chine :

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 fumée en direct

Utilisez un répertoire d’état isolé lorsque vous voulez vérifier l’accès au modèle et le suivi des coûts sans toucher à vos sessions 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 réponse JSON doit indiquer provider: "moonshot" et model: "kimi-k2.6". L’entrée de transcription de l’assistant stocke l’utilisation normalisée des jetons ainsi que le coût estimé sous usage.cost lorsque Moonshot renvoie des 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.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
        ],
      },
    },
  },
}

Kimi Coding

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

Exécuter l’onboarding

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

Définir un modèle par défaut

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

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-code" },
      models: {
        "kimi/kimi-code": { alias: "Kimi" },
      },
    },
  },
}

Recherche web Kimi

OpenClaw fournit aussi Kimi comme fournisseur web_search, basé sur la recherche web Moonshot.

Exécuter la configuration interactive de recherche web

openclaw configure --section web

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

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

La configuration interactive demande :

Setting	Options
API region	`https://api.moonshot.ai/v1` (international) or `https://api.moonshot.cn/v1` (China)
Web search model	Defaults to `kimi-k2.6`

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 réflexion natif

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.6": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}

OpenClaw mappe aussi les niveaux /think à l’exécution pour Moonshot :

`/think` level	Moonshot behavior
`/think off`	`thinking.type=disabled`
Any non-off level	`thinking.type=enabled`

Kimi K2.6 accepte aussi un champ optionnel thinking.keep qui contrôle la conservation multi-tour de reasoning_content. 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 des autres modèles.

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

Assainissement des identifiants d’appel d’outil

Moonshot Kimi sert des IDs tool_call de la forme functions.<name>:<index>. OpenClaw les préserve tels quels afin que les appels d’outil multi-tours continuent de fonctionner.

Pour forcer un assainissement strict sur un fournisseur personnalisé compatible OpenAI, définissez sanitizeToolCallIds: true :

{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}

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 sur le transport partagé openai-completions. OpenClaw se base sur les capacités du point de terminaison, de sorte que les identifiants de fournisseur personnalisés compatibles ciblant les mêmes hôtes Moonshot natifs héritent du même comportement d’utilisation en streaming.

Avec la tarification K2.6 intégrée, l’utilisation en streaming qui comprend les jetons d’entrée, de sortie et de lecture de cache est aussi convertie en coût local estimé en USD pour /status, /usage full, /usage cost, et la comptabilité de session basée sur les transcriptions.

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

Provider	Model ref prefix	Endpoint	Auth env var
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`
Web search	N/A	Identique à la région d’API Moonshot	`KIMI_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.6.
Remplacez la tarification et les métadonnées 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.

Lié

Sélection du modèle

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

Recherche web

Configurer les 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.

# Catalogue de modèles intégré

# Premiers pas

API Moonshot

Choisir votre région de point de terminaison

Exécuter l’onboarding

Définir un modèle par défaut

Vérifier que les modèles sont disponibles

Exécuter un test de fumée en direct

# Exemple de configuration

Kimi Coding

Exécuter l’onboarding

Définir un modèle par défaut

Vérifier que le modèle est disponible

# Exemple de configuration

# Recherche web Kimi

Exécuter la configuration interactive de recherche web

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

# Configuration avancée

# Lié

Catalogue de modèles intégré

Premiers pas

Exemple de configuration

Exemple de configuration

Recherche web Kimi

Configuration avancée

Lié