Przejdź do głównej treści

​
Moonshot AI (Kimi)

Moonshot udostępnia API Kimi z endpointami zgodnymi z OpenAI. Skonfiguruj dostawcę i ustaw domyślny model na moonshot/kimi-k2.5, albo użyj Kimi Coding z kimi/kimi-code.
Moonshot i Kimi Coding to oddzielni dostawcy. Klucze nie są zamienne, endpointy są różne, a odwołania do modeli też się różnią (moonshot/... vs kimi/...).

​
Wbudowany katalog modeli

Odwołanie modeluNazwaReasoningWejścieKontekstMaks. wyjście
moonshot/kimi-k2.5Kimi K2.5Nietext, image262,144262,144
moonshot/kimi-k2-thinkingKimi K2 ThinkingTaktext262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking TurboTaktext262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboNietext256,00016,384

​
Pierwsze kroki

Wybierz dostawcę i wykonaj kroki konfiguracji.
Najlepsze do: modeli Kimi K2 przez Moonshot Open Platform.
1

Wybierz region endpointu

Wybór uwierzytelnianiaEndpointRegion
moonshot-api-keyhttps://api.moonshot.ai/v1Międzynarodowy
moonshot-api-key-cnhttps://api.moonshot.cn/v1Chiny
2

Uruchom onboarding

openclaw onboard --auth-choice moonshot-api-key
Albo dla endpointu w Chinach:
openclaw onboard --auth-choice moonshot-api-key-cn
3

Ustaw model domyślny

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

Sprawdź, czy modele są dostępne

openclaw models list --provider moonshot

​
Przykład konfiguracji

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

​
Wyszukiwanie w sieci Kimi

OpenClaw zawiera też Kimi jako dostawcę web_search, oparty na wyszukiwaniu w sieci Moonshot.
1

Uruchom interaktywną konfigurację wyszukiwania w sieci

openclaw configure --section web
W sekcji wyszukiwania w sieci wybierz Kimi, aby zapisać plugins.entries.moonshot.config.webSearch.*.
2

Skonfiguruj region wyszukiwania w sieci i model

Interaktywna konfiguracja pyta o:
UstawienieOpcje
Region APIhttps://api.moonshot.ai/v1 (międzynarodowy) lub https://api.moonshot.cn/v1 (Chiny)
Model wyszukiwania w sieciDomyślnie kimi-k2.5
Konfiguracja znajduje się pod plugins.entries.moonshot.config.webSearch: 
{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // lub użyj KIMI_API_KEY / MOONSHOT_API_KEY
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.5",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

​
Zaawansowane

Moonshot Kimi obsługuje binarny natywny tryb thinking:
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
Skonfiguruj go per model przez agents.defaults.models.<provider/model>.params:
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.5": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
OpenClaw mapuje też poziomy /think w czasie działania dla Moonshot:
Poziom /thinkZachowanie Moonshot
/think offthinking.type=disabled
Dowolny poziom inny niż offthinking.type=enabled
Gdy thinking Moonshot jest włączone, tool_choice musi mieć wartość auto albo none. OpenClaw normalizuje niezgodne wartości tool_choice do auto dla zgodności.
Natywne endpointy Moonshot (https://api.moonshot.ai/v1 i https://api.moonshot.cn/v1) deklarują zgodność użycia streamingu na współdzielonym transporcie openai-completions. OpenClaw opiera się na możliwościach endpointu, więc zgodne niestandardowe identyfikatory dostawców kierujące na te same natywne hosty Moonshot dziedziczą to samo zachowanie użycia streamingu.
DostawcaPrefiks odwołania modeluEndpointZmienna środowiskowa uwierzytelniania
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/endpoint Kimi CodingKIMI_API_KEY
Wyszukiwanie w sieciN/ATaki sam jak region API MoonshotKIMI_API_KEY lub MOONSHOT_API_KEY
  • Wyszukiwanie w sieci Kimi używa KIMI_API_KEY lub MOONSHOT_API_KEY, a domyślnie korzysta z https://api.moonshot.ai/v1 z modelem kimi-k2.5.
  • W razie potrzeby nadpisz ceny i metadane kontekstowe w models.providers.
  • Jeśli Moonshot opublikuje inne limity kontekstu dla modelu, odpowiednio dostosuj contextWindow.

​
Powiązane

Wybór modelu

Wybór dostawców, odwołań do modeli i zachowania failover.

Wyszukiwanie w sieci

Konfigurowanie dostawców wyszukiwania w sieci, w tym Kimi.

Referencja konfiguracji

Pełny schemat konfiguracji dostawców, modeli i Plugin.

Moonshot Open Platform

Zarządzanie kluczami API Moonshot i dokumentacja.