Zum Hauptinhalt springen
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 Modell-Refs unterscheiden sich (moonshot/... vs. kimi/...).

Integrierter Modellkatalog

Modell-RefNameReasoningEingabeKontextMax. Ausgabe
moonshot/kimi-k2.6Kimi K2.6NeinText, Bild262,144262,144
moonshot/kimi-k2.7-codeKimi K2.7 CodeImmer aktivText, 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
Die Kostenschätzungen im Katalog für aktuelle von Moonshot gehostete K2-Modelle verwenden Moonshots veröffentlichte Pay-as-you-go-Tarife: Kimi K2.7 Code kostet 0,19 /MTokCacheHit,0,95/MTok Cache-Hit, 0,95 /MTok Eingabe und 4,00 /MTokAusgabe;KimiK2.6kostet0,16/MTok Ausgabe; Kimi K2.6 kostet 0,16 /MTok Cache-Hit, 0,95 /MTokEingabeund4,00/MTok Eingabe und 4,00 /MTok Ausgabe; Kimi K2.5 kostet 0,10 /MTokCacheHit,0,60/MTok Cache-Hit, 0,60 /MTok Eingabe und 3,00 $/MTok Ausgabe. Andere ältere Katalogeinträge behalten Nullkosten-Platzhalter, sofern Sie sie nicht in der Konfiguration überschreiben. Kimi K2.7 Code verwendet immer natives Denken. OpenClaw stellt für dieses Modell nur den Denkzustand on bereit und lässt ausgehende Steuerelemente für thinking und reasoning_effort weg, wie von Moonshot gefordert. OpenClaw lässt außerdem Sampling-Overrides weg, die K2.7 auf Provider-Standardwerte festlegt. Kimi K2.6 bleibt der Onboarding-Standard.

Erste Schritte

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

Endpunktregion wä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

Standardmodell festlegen

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

Prüfen, ob Modelle verfügbar sind

openclaw models list --provider moonshot
5

Live-Smoke-Test ausführen

Verwenden Sie ein isoliertes Zustandsverzeichnis, wenn Sie Modellzugriff und Kostenerfassung prüfen möchten, ohne Ihre normalen Sitzungen zu berühren:
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 Transkripteintrag des Assistenten 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.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
        ],
      },
    },
  },
}

Kimi-Websuche

Das Moonshot-Plugin registriert außerdem Kimi als web_search-Provider, gestützt durch Moonshot-Websuche.
1

Interaktive Websuche-Einrichtung ausführen

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

Websuche-Region und Modell konfigurieren

Die interaktive Einrichtung fragt nach:
EinstellungOptionen
API-Regionhttps://api.moonshot.ai/v1 (international) oder https://api.moonshot.cn/v1 (China)
Websuche-ModellStandardmäß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

Kimi K2.7 Code verwendet immer natives Denken. Moonshot verlangt, dass Clients das Feld thinking für dieses Modell weglassen; daher stellt OpenClaw nur on bereit und ignoriert veraltete off-Einstellungen. K2.7 legt außerdem temperature, top_p, n, presence_penalty und frequency_penalty fest; OpenClaw lässt konfigurierte Overrides für diese Felder weg.Andere Moonshot-Kimi-Modelle unterstützen binäres natives Denken:
  • 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 Laufzeit-/think-Stufen für diese Modelle zu:
/think-StufeMoonshot-Verhalten
/think offthinking.type=disabled
Jede Nicht-off-Stufethinking.type=enabled
Wenn Moonshot-Denken aktiviert ist, muss tool_choice auto oder none sein. OpenClaw normalisiert inkompatible Werte auf auto. Dies schließt Kimi K2.7 Code ein, dessen Denkmodus nicht deaktiviert werden kann, um eine festgelegte Tool-Auswahl beizubehalten.
Kimi K2.6 akzeptiert auch ein optionales Feld thinking.keep, das die Multi-Turn-Beibehaltung von reasoning_content steuert. Setzen Sie es auf "all", um die vollständige Reasoning-Historie über Turns hinweg beizubehalten; lassen Sie es weg (oder lassen Sie es 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. Kimi K2.7 Code bewahrt standardmäßig die vollständige Reasoning-Historie, während OpenClaw das gesamte Feld thinking weglässt.
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
Moonshot Kimi liefert native tool_call-IDs im Format functions.<name>:<index>. Für den OpenAI-Completions-Transport bewahrt OpenClaw das erste Vorkommen jeder nativen Kimi-ID und schreibt spätere Duplikate in deterministische OpenAI-artige call_*-IDs um. Passende Tool-Ergebnisse werden mit derselben ID neu zugeordnet, sodass der Replay eindeutig bleibt, ohne Kimis erste native ID zu entfernen.Um für einen benutzerdefinierten OpenAI-kompatiblen Provider eine strikte Bereinigung zu erzwingen, setzen Sie sanitizeToolCallIds: true:
{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}
Native Moonshot-Endpoints (https://api.moonshot.ai/v1 und https://api.moonshot.cn/v1) weisen Streaming-Nutzungskompatibilität auf dem gemeinsamen openai-completions-Transport aus. OpenClaw richtet sich dabei nach Endpoint-Fähigkeiten, sodass kompatible benutzerdefinierte Provider-IDs, die auf dieselben nativen Moonshot-Hosts zielen, dasselbe Streaming-Usage-Verhalten übernehmen.Mit der K2.6-Preisgestaltung aus dem Katalog wird gestreamte Nutzung, die Input-, Output- und Cache-Read-Tokens enthält, außerdem in lokal geschätzte USD-Kosten für /status, /usage full, /usage cost und die transkriptgestützte Sitzungsabrechnung umgerechnet.
ProviderModellref-PräfixEndpointAuth-Umgebungsvariable
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Kimi-Coding-EndpointKIMI_API_KEY
Websuchek. A.Wie 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.6.
  • Überschreiben Sie bei Bedarf Preis- und Kontextmetadaten in models.providers.
  • Wenn Moonshot andere Kontextlimits für ein Modell veröffentlicht, passen Sie contextWindow entsprechend an.

Verwandte Themen

Modellauswahl

Provider, Modellrefs und Failover-Verhalten auswählen.

Websuche

Websuche-Provider einschließlich Kimi konfigurieren.

Konfigurationsreferenz

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

Moonshot Open Platform

Moonshot-API-Schlüsselverwaltung und Dokumentation.