Zum Hauptinhalt springen

​
Moonshot AI (Kimi)

Moonshot stellt die Kimi-API mit OpenAI-kompatiblen Endpunkten bereit. Konfigurieren Sie den Provider und setzen Sie das Standardmodell auf moonshot/kimi-k2.5, oder verwenden Sie Kimi Coding mit kimi/kimi-code.
Moonshot und Kimi Coding sind separate Provider. Schlüssel sind nicht austauschbar, Endpunkte unterscheiden sich und Modell-Refs unterscheiden sich ebenfalls (moonshot/... vs. kimi/...).

​
Integrierter Modellkatalog

Modell-RefNameReasoningEingabeKontextMaximale Ausgabe
moonshot/kimi-k2.5Kimi K2.5Neintext, image262,144262,144
moonshot/kimi-k2-thinkingKimi K2 ThinkingJatext262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking TurboJatext262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboNeintext256,00016,384

​
Erste Schritte

Wählen Sie Ihren Provider und folgen Sie den Einrichtungsschritten.
Am besten geeignet für: Kimi-K2-Modelle über die Moonshot Open Platform.
1

Ihre Endpunkt-Region auswählen

Auth-AuswahlEndpunktRegion
moonshot-api-keyhttps://api.moonshot.ai/v1International
moonshot-api-key-cnhttps://api.moonshot.cn/v1China
2

Onboarding ausführen

openclaw onboard --auth-choice moonshot-api-key
Oder für den China-Endpunkt:
openclaw onboard --auth-choice moonshot-api-key-cn
3

Ein Standardmodell festlegen

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

Prüfen, ob Modelle verfügbar sind

openclaw models list --provider moonshot

​
Konfigurationsbeispiel

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

​
Kimi-Websuche

OpenClaw enthält außerdem Kimi als web_search-Provider, unterstützt durch die Moonshot-Websuche.
1

Interaktive Einrichtung der Websuche ausführen

openclaw configure --section web
Wählen Sie im Abschnitt zur Websuche Kimi, um plugins.entries.moonshot.config.webSearch.* zu speichern.
2

Region und Modell für die Websuche konfigurieren

Bei der interaktiven Einrichtung werden Sie nach Folgendem gefragt:
EinstellungOptionen
API-Regionhttps://api.moonshot.ai/v1 (international) oder https://api.moonshot.cn/v1 (China)
WebsuchmodellStandardmäßig kimi-k2.5
Die Konfiguration befindet sich unter plugins.entries.moonshot.config.webSearch: 
{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // oder KIMI_API_KEY / MOONSHOT_API_KEY verwenden
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.5",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

​
Erweitert

Moonshot Kimi unterstützt binäres natives Thinking:
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
Konfigurieren Sie es pro Modell über agents.defaults.models.<provider/model>.params:
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.5": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
OpenClaw bildet auch Laufzeit-/think-Stufen für Moonshot ab:
Stufe von /thinkMoonshot-Verhalten
/think offthinking.type=disabled
Jede Stufe außer offthinking.type=enabled
Wenn Moonshot-Thinking aktiviert ist, muss tool_choice auf auto oder none gesetzt sein. OpenClaw normalisiert nicht kompatible tool_choice-Werte aus Kompatibilitätsgründen auf auto.
Native Moonshot-Endpunkte (https://api.moonshot.ai/v1 und https://api.moonshot.cn/v1) deklarieren Streaming-Nutzungskompatibilität auf dem gemeinsamen Transport openai-completions. OpenClaw leitet dies aus den Endpunkt- Fähigkeiten ab, daher übernehmen kompatible benutzerdefinierte Provider-IDs, die auf dieselben nativen Moonshot-Hosts zielen, dasselbe Verhalten für Streaming-Nutzung.
ProviderPräfix für Modell-RefsEndpunktAuth-Umgebungsvariable
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Kimi-Coding-EndpunktKIMI_API_KEY
WebsucheN/AWie die Moonshot-API-RegionKIMI_API_KEY oder MOONSHOT_API_KEY
  • Die Kimi-Websuche verwendet KIMI_API_KEY oder MOONSHOT_API_KEY und nutzt standardmäßig https://api.moonshot.ai/v1 mit dem Modell kimi-k2.5.
  • Überschreiben Sie bei Bedarf Preis- und Kontextmetadaten in models.providers.
  • Wenn Moonshot für ein Modell andere Kontextlimits veröffentlicht, passen Sie contextWindow entsprechend an.

​
Verwandt

Modellauswahl

Auswahl von Providern, Modell-Refs und Failover-Verhalten.

Websuche

Konfigurieren von Websuch-Providern einschließlich Kimi.

Konfigurationsreferenz

Vollständiges Konfigurationsschema für Provider, Modelle und Plugins.

Moonshot Open Platform

Verwaltung von Moonshot-API-Schlüsseln und Dokumentation.