Providers

Moonshot AI

Moonshot udostępnia API Kimi z endpointami zgodnymi z OpenAI. Skonfiguruj providera i ustaw model domyślny na moonshot/kimi-k2.6, albo użyj Kimi Coding z kimi/kimi-code.

Wbudowany katalog modeli

Model ref Nazwa Reasoning Wejście Kontekst Maks. wyjście
moonshot/kimi-k2.6 Kimi K2.6 Nie text, image 262,144 262,144
moonshot/kimi-k2.5 Kimi K2.5 Nie text, image 262,144 262,144
moonshot/kimi-k2-thinking Kimi K2 Thinking Tak text 262,144 262,144
moonshot/kimi-k2-thinking-turbo Kimi K2 Thinking Turbo Tak text 262,144 262,144
moonshot/kimi-k2-turbo Kimi K2 Turbo Nie text 256,000 16,384

Dołączone szacunki kosztów dla obecnie hostowanych przez Moonshot modeli K2 używają opublikowanych stawek pay-as-you-go Moonshot: Kimi K2.6 kosztuje $0.16/MTok za trafienie cache, $0.95/MTok za wejście i $4.00/MTok za wyjście; Kimi K2.5 kosztuje $0.10/MTok za trafienie cache, $0.60/MTok za wejście i $3.00/MTok za wyjście. Inne starsze wpisy katalogu zachowują placeholdery kosztów zerowych, chyba że nadpiszesz je w konfiguracji.

Pierwsze kroki

Wybierz providera i wykonaj kroki konfiguracji.

Moonshot API

Najlepsze do: modeli Kimi K2 przez Moonshot Open Platform.

  • Wybierz region endpointu

    Opcja uwierzytelniania Endpoint Region
    moonshot-api-key https://api.moonshot.ai/v1 Międzynarodowy
    moonshot-api-key-cn https://api.moonshot.cn/v1 Chiny
  • Uruchom onboarding

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

    Lub dla endpointu w Chinach:

    openclaw onboard --auth-choice moonshot-api-key-cn
    
  • Ustaw model domyślny

    {
      agents: {
        defaults: {
          model: { primary: "moonshot/kimi-k2.6" },
        },
      },
    }
    
  • Sprawdź, czy modele są dostępne

    openclaw models list --provider moonshot
    
  • Uruchom test smoke live

    Użyj izolowanego katalogu stanu, jeśli chcesz sprawdzić dostęp do modelu i śledzenie kosztów bez dotykania normalnych sesji:

    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
    

    Odpowiedź JSON powinna raportować provider: "moonshot" oraz model: "kimi-k2.6". Wpis transkryptu asystenta przechowuje znormalizowane użycie tokenów oraz szacowany koszt w usage.cost, gdy Moonshot zwraca metadane użycia.

  • Przykład konfiguracji

    {
      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

    Najlepsze do: zadań skoncentrowanych na kodzie przez endpoint Kimi Coding.

  • Uruchom onboarding

    openclaw onboard --auth-choice kimi-code-api-key
    
  • Ustaw model domyślny

    {
      agents: {
        defaults: {
          model: { primary: "kimi/kimi-code" },
        },
      },
    }
    
  • Sprawdź, czy model jest dostępny

    openclaw models list --provider kimi
    
  • Przykład konfiguracji

    {
      env: { KIMI_API_KEY: "sk-..." },
      agents: {
        defaults: {
          model: { primary: "kimi/kimi-code" },
          models: {
            "kimi/kimi-code": { alias: "Kimi" },
          },
        },
      },
    }
    

    Wyszukiwanie w sieci Kimi

    OpenClaw dostarcza także Kimi jako providera web_search, opartego na Moonshot web search.

  • Uruchom interaktywną konfigurację wyszukiwania w sieci

    openclaw configure --section web
    

    W sekcji wyszukiwania w sieci wybierz Kimi, aby zapisać plugins.entries.moonshot.config.webSearch.*.

  • Skonfiguruj region wyszukiwania w sieci i model

    Interaktywna konfiguracja pyta o:

    Ustawienie Opcje
    Region API https://api.moonshot.ai/v1 (międzynarodowy) lub https://api.moonshot.cn/v1 (Chiny)
    Model wyszukiwania w sieci Domyślnie kimi-k2.6
  • 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.6",
              },
            },
          },
        },
      },
      tools: {
        web: {
          search: {
            provider: "kimi",
          },
        },
      },
    }
    

    Konfiguracja zaawansowana

    Natywny tryb myślenia

    Moonshot Kimi obsługuje binarny natywny tryb myślenia:

    • thinking: { type: "enabled" }
    • thinking: { type: "disabled" }

    Skonfiguruj go per model przez agents.defaults.models.<provider/model>.params:

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

    OpenClaw mapuje także poziomy runtime /think dla Moonshot:

    Poziom /think Zachowanie Moonshot
    /think off thinking.type=disabled
    Dowolny poziom inny niż off thinking.type=enabled

    Kimi K2.6 akceptuje również opcjonalne pole thinking.keep, które kontroluje zachowanie reasoning_content między wieloma turami. Ustaw je na "all", aby zachować pełne reasoning między turami; pomiń je (albo pozostaw null), aby użyć domyślnej strategii serwera. OpenClaw przekazuje thinking.keep tylko dla moonshot/kimi-k2.6 i usuwa je z innych modeli.

    {
      agents: {
        defaults: {
          models: {
            "moonshot/kimi-k2.6": {
              params: {
                thinking: { type: "enabled", keep: "all" },
              },
            },
          },
        },
      },
    }
    
    Sanityzacja identyfikatora wywołania narzędzia

    Moonshot Kimi zwraca identyfikatory tool_call w postaci functions.<name>:<index>. OpenClaw zachowuje je bez zmian, dzięki czemu wywołania narzędzi w wielu turach nadal działają.

    Aby wymusić ścisłą sanityzację dla własnego providera zgodnego z OpenAI, ustaw sanitizeToolCallIds: true:

    {
      models: {
        providers: {
          "my-kimi-proxy": {
            api: "openai-completions",
            sanitizeToolCallIds: true,
          },
        },
      },
    }
    
    Zgodność użycia streamingu

    Natywne endpointy Moonshot (https://api.moonshot.ai/v1 i https://api.moonshot.cn/v1) ogłaszają zgodność użycia streamingu na współdzielonym transporcie openai-completions. OpenClaw opiera się na capabilities endpointu, więc zgodne własne identyfikatory providerów kierowane do tych samych natywnych hostów Moonshot dziedziczą to samo zachowanie użycia streamingu.

    Przy dołączonych cenach K2.6 użycie streamowane, które obejmuje tokeny wejścia, wyjścia i odczytu z cache, jest również przeliczane na lokalny szacowany koszt w USD dla /status, /usage full, /usage cost i rozliczania sesji opartego na transkrypcie.

    Dokumentacja endpointów i referencji modeli
    Provider Prefiks model ref Endpoint Zmienna env uwierzytelniania
    Moonshot moonshot/ https://api.moonshot.ai/v1 MOONSHOT_API_KEY
    Moonshot CN moonshot/ https://api.moonshot.cn/v1 MOONSHOT_API_KEY
    Kimi Coding kimi/ Endpoint Kimi Coding KIMI_API_KEY
    Wyszukiwanie w sieci N/A Takie samo jak region API Moonshot KIMI_API_KEY lub MOONSHOT_API_KEY
    • Wyszukiwanie w sieci Kimi używa KIMI_API_KEY lub MOONSHOT_API_KEY i domyślnie korzysta z https://api.moonshot.ai/v1 z modelem kimi-k2.6.
    • W razie potrzeby nadpisz ceny i metadane kontekstu w models.providers.
    • Jeśli Moonshot opublikuje inne limity kontekstu dla modelu, odpowiednio dostosuj contextWindow.

    Powiązane