Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Moonshot stellt die Kimi API mit OpenAI-kompatiblen Endpunkten bereit. Konfigurieren Sie den Provider und setzen Sie das Standardmodell auf moonshot/kimi-k2.6, oder verwenden Sie Kimi Coding mit kimi/kimi-for-coding.
Moonshot und Kimi Coding sind separate Provider. Schlüssel sind nicht austauschbar, Endpunkte unterscheiden sich, und Modellreferenzen unterscheiden sich (moonshot/... gegenüber kimi/...).

Integrierter Modellkatalog

ModellreferenzNameSchlussfolgernEingabeKontextMax. Ausgabe
moonshot/kimi-k2.6Kimi K2.6NeinText, Bild262,144262,144
moonshot/kimi-k2.5Kimi K2.5NeinText, Bild262,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
Gebündelte Kostenschätzungen für aktuelle von Moonshot gehostete K2-Modelle verwenden die von Moonshot veröffentlichten nutzungsbasierten Tarife: Kimi K2.6 kostet 0,16 USD/MTok bei Cache-Treffern, 0,95 USD/MTok Eingabe und 4,00 USD/MTok Ausgabe; Kimi K2.5 kostet 0,10 USD/MTok bei Cache-Treffern, 0,60 USD/MTok Eingabe und 3,00 USD/MTok Ausgabe. Andere ältere Katalogeinträge behalten Nullkosten-Platzhalter, sofern Sie sie nicht in der Konfiguration überschreiben.

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

Endpunktregion auswählen

AuthentifizierungsauswahlEndpunktRegion
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

Standardmodell festlegen

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

Verifizieren, dass Modelle verfügbar sind

openclaw models list --provider moonshot
5

Live-Smoke-Test ausführen

Verwenden Sie ein isoliertes Zustandsverzeichnis, wenn Sie Modellzugriff und Kostenverfolgung verifizieren möchten, ohne Ihre normalen Sitzungen zu verändern:
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
Die JSON-Antwort sollte provider: "moonshot" und model: "kimi-k2.6" melden. Der Assistant-Transkripteintrag speichert normalisierte Token-Nutzung plus geschätzte Kosten unter usage.cost, wenn Moonshot Nutzungsmetadaten zurückgibt.

Konfigurationsbeispiel

{
  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-Websuche

OpenClaw liefert außerdem Kimi als web_search-Provider aus, gestützt durch Moonshot-Websuche.
1

Interaktive Einrichtung der Websuche ausführen

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

Websuchregion und Modell konfigurieren

Die interaktive Einrichtung fragt Folgendes ab:
EinstellungOptionen
API-Regionhttps://api.moonshot.ai/v1 (international) oder https://api.moonshot.cn/v1 (China)
WebsuchmodellStandardmäßig kimi-k2.6
Die Konfiguration befindet sich unter 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",
      },
    },
  },
}

Erweiterte Konfiguration

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.6": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
OpenClaw ordnet außerdem Laufzeit-/think-Stufen für Moonshot zu:
/think-StufeMoonshot-Verhalten
/think offthinking.type=disabled
Jede Stufe außer offthinking.type=enabled
Wenn Moonshot-Thinking aktiviert ist, muss tool_choice auto oder none sein. OpenClaw normalisiert inkompatible tool_choice-Werte aus Kompatibilitätsgründen zu auto.
Kimi K2.6 akzeptiert außerdem ein optionales Feld thinking.keep, das die Mehrfachzug-Beibehaltung von reasoning_content steuert. Setzen Sie es auf "all", um das vollständige Reasoning über Züge hinweg beizubehalten; lassen Sie es weg (oder belassen Sie es bei null), um die Standardstrategie des Servers zu verwenden. OpenClaw leitet thinking.keep nur für moonshot/kimi-k2.6 weiter und entfernt es aus anderen Modellen.
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
Moonshot Kimi stellt tool_call-IDs in der Form functions.<name>:<index> bereit. OpenClaw behält sie unverändert bei, damit Tool-Aufrufe über mehrere Züge hinweg weiterhin funktionieren.Um eine strikte Bereinigung für einen benutzerdefinierten OpenAI-kompatiblen Provider zu erzwingen, setzen Sie sanitizeToolCallIds: true:
{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}
Native Moonshot-Endpunkte (https://api.moonshot.ai/v1 und https://api.moonshot.cn/v1) geben Streaming-Nutzungsdaten-Kompatibilität auf dem gemeinsamen openai-completions-Transport an. OpenClaw leitet dies aus den Endpunktfähigkeiten ab, sodass kompatible benutzerdefinierte Provider-IDs, die dieselben nativen Moonshot-Hosts ansprechen, dasselbe Streaming-Nutzungsdaten-Verhalten übernehmen.Mit der gebündelten K2.6-Preisgestaltung wird gestreamte Nutzung, die Eingabe-, Ausgabe- und Cache-Read-Token umfasst, außerdem in lokal geschätzte USD-Kosten für /status, /usage full, /usage cost und transcript-gestützte Sitzungsabrechnung umgerechnet.
ProviderPräfix der ModellreferenzEndpunktAuth-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
WebsucheNicht zutreffendIdentisch mit der 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.6.
  • Überschreiben Sie Preis- und Kontextmetadaten bei Bedarf in models.providers.
  • Wenn Moonshot für ein Modell andere Kontextlimits veröffentlicht, passen Sie contextWindow entsprechend an.

Verwandte Themen

Modellauswahl

Auswahl von Providern, Modellreferenzen und Failover-Verhalten.

Websuche

Konfiguration von Websuche-Providern einschließlich Kimi.

Konfigurationsreferenz

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

Moonshot Open Platform

Moonshot-API-Schlüsselverwaltung und Dokumentation.