OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Moonshot AI

Moonshot, OpenAI uyumlu uç noktalarla Kimi API'yi sağlar. Kimi K3 için moonshot/kimi-k3 seçeneğini belirleyin, ilk kurulum varsayılanı olan moonshot/kimi-k2.6 değerini koruyun veya Kimi Coding için kimi/kimi-for-coding kullanın.

Yerleşik model kataloğu

Model referansı Ad Akıl yürütme Girdi Bağlam Maks. çıktı
moonshot/kimi-k2.6 Kimi K2.6 Hayır metin, görsel 262,144 262,144
moonshot/kimi-k3 Kimi K3 Daima maksimum metin, görsel 1,048,576 1,048,576
moonshot/kimi-k2.7-code Kimi K2.7 Code Daima açık metin, görsel 262,144 262,144
moonshot/kimi-k2.7-code-highspeed Kimi K2.7 Code HighSpeed Daima açık metin, görsel 262,144 262,144
moonshot/kimi-k2.5 Kimi K2.5 Hayır metin, görsel 262,144 262,144

Katalog maliyet tahminleri, Moonshot'ın yayımladığı kullandıkça öde tarifelerini kullanır. Maliyet kararları vermeden önce Kimi K3, Kimi K2.7 Code, Kimi K2.6 ve Kimi K2.5 için güncel sağlayıcı sayfalarını kontrol edin.

Kimi K3, her zaman reasoning_effort: "max" düzeyinde akıl yürütür. OpenClaw yalnızca /think max seçeneğini sunar, yalnızca K2'ye özgü thinking alanını dahil etmez ve K3'ün sağlayıcı varsayılanlarına sabitlediği örnekleme geçersiz kılmalarını (temperature, top_p, n, presence_penalty ve frequency_penalty) kaldırır. Kimi K2.7 Code da her zaman yerel düşünmeyi kullanır ancak hem thinking hem de reasoning_effort alanlarının dahil edilmemesini gerektirir; HighSpeed varyantı aynı sözleşmeyi kullanır. Kimi K2.6, ilk kurulum varsayılanı olarak kalır. Moonshot'ın Kimi K3 hızlı başlangıç kılavuzuna bakın.

Başlarken

Hem Moonshot hem de Kimi Coding harici eklentilerdir; ilk kurulumdan önce bunlardan birini yükleyin.

Moonshot API

En uygun olduğu durum: Moonshot Open Platform üzerinden Kimi K3 ve K2 modelleri.

  • Eklentiyi yükleyin

    bash
    openclaw plugins install @openclaw/moonshot-provideropenclaw gateway restart

  • Uç nokta bölgenizi seçin

    Kimlik doğrulama seçeneği Uç nokta Bölge
    moonshot-api-key https://api.moonshot.ai/v1 Uluslararası
    moonshot-api-key-cn https://api.moonshot.cn/v1 Çin

  • İlk kurulumu çalıştırın

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

    Çin uç noktası için ise:

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

  • Kimi K3'ü varsayılan model olarak ayarlayın

    İlk kurulum, başlangıç varsayılanı olarak Kimi K2.6'yı korur. Kimi K3'ü kullanmak istediğinizde açıkça geçiş yapın:

    bash
    openclaw models set moonshot/kimi-k3

  • Modellerin kullanılabilir olduğunu doğrulayın

    bash
    openclaw models list --provider moonshot

  • Canlı bir hızlı doğrulama testi çalıştırın

    Normal oturumlarınıza dokunmadan model erişimini ve maliyet takibini doğrulamak istediğinizde yalıtılmış bir durum dizini kullanın:

    bash
    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 max \  --json

    JSON yanıtı provider: "moonshot" ve model: "kimi-k3" değerlerini bildirmelidir. Moonshot kullanım meta verilerini döndürdüğünde asistan dökümündeki girdi, normalleştirilmiş token kullanımını ve tahmini maliyeti usage.cost altında saklar.

    • Yapılandırma örneği

    json5
    {  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-k3": { alias: "Kimi K3" },        "moonshot/kimi-k2.7-code": { alias: "Kimi K2.7 Code" },        "moonshot/kimi-k2.7-code-highspeed": { alias: "Kimi K2.7 Code HighSpeed" },        "moonshot/kimi-k2.5": { alias: "Kimi K2.5" },        // 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-k3",            name: "Kimi K3",            reasoning: true,            thinkingLevelMap: {              off: null,              minimal: null,              low: null,              medium: null,              high: null,              xhigh: "max",              max: "max",            },            input: ["text", "image"],            cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 0 },            contextWindow: 1048576,            maxTokens: 1048576,          },          {            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.7-code-highspeed",            name: "Kimi K2.7 Code HighSpeed",            reasoning: true,            input: ["text", "image"],            cost: { input: 1.9, output: 8, cacheRead: 0.38, 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,          },          // moonshot-kimi-k2-models:end        ],      },    },  },}

    Kimi Coding

    En uygun olduğu durum: Kimi Coding uç noktası üzerinden kod odaklı görevler.

    Kodlama hizmeti hem OpenAI uyumlu https://api.kimi.com/coding/v1 hem de Anthropic uyumlu https://api.kimi.com/coding/ istemcilerini kabul eder. Bu eklenti Anthropic Messages kullanır. Üyelik anahtarlarını Kimi Code Console üzerinden oluşturun; güncel üyelik fiyatları Kimi'nin fiyatlandırma sayfasında yer alır.

  • Eklentiyi yükleyin

    bash
    openclaw plugins install @openclaw/kimi-provideropenclaw gateway restart

  • İlk kurulumu çalıştırın

    bash
    openclaw onboard --auth-choice kimi-code-api-key

  • Varsayılan bir model ayarlayın

    json5
    {  agents: {    defaults: {      model: { primary: "kimi/kimi-for-coding" },    },  },}

  • Modelin kullanılabilir olduğunu doğrulayın

    bash
    openclaw models list --provider kimi

    • Kimi Code K3, varsayılan olarak max düzeyinde derin düşünmeyi kullanır. /think off, thinking.type: "disabled" değerini gönderir; /think max, K3'ün uyarlanabilir düşünme isteğini maksimum çabayla gönderir. Güncelliğini yitirmiş daha düşük düşünme düzeyleri, desteklenen max düzeyine çözümlenir. 1M modeli, Allegretto veya daha yüksek bir Kimi üyeliği gerektirir; Moderato'da kimi/k3 kullanın.

    Güncel plan kullanılabilirliği için resmî Kimi Code model tablosuna bakın.

    Yapılandırma örneği

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

    Kimi web araması

    Moonshot eklentisi ayrıca Moonshot web aramasıyla desteklenen Kimi'yi bir web_search sağlayıcısı olarak kaydeder.

  • Etkileşimli web araması kurulumunu çalıştırın

    bash
    openclaw configure --section web

    plugins.entries.moonshot.config.webSearch.* değerini saklamak için web araması bölümünde Kimi'yi seçin.

  • Web araması bölgesini ve modelini yapılandırın

    Etkileşimli kurulum şunları sorar:

    Ayar Seçenekler
    API bölgesi https://api.moonshot.ai/v1 (uluslararası) veya https://api.moonshot.cn/v1 (Çin)
    Web araması modeli Varsayılan olarak kimi-k2.6

    • Yapılandırma plugins.entries.moonshot.config.webSearch altında bulunur:

    json5
    {  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",      },    },  },}

    Gelişmiş yapılandırma

    Yerel düşünme modu

    Moonshot API Kimi K3, her zaman maksimum çabayla akıl yürütür. OpenClaw yalnızca /think max seçeneğini sunar, reasoning_effort: "max" değerini gönderir ve güncelliğini yitirmiş daha düşük veya off ayarlarını yok sayar.

    Kimi Code K3, /think off|max sunar. Anthropic uyumlu uç noktası, kapalı durum için thinking.type: "disabled", maksimum durum için ise output_config.effort: "max" ile uyarlamalı düşünme alır. Bu, hem kimi/k3 hem de kimi/k3[1m] için geçerlidir. Moonshot API K3; auto, none, required ve sabitlenmiş araç seçimlerini destekler, bu nedenle OpenClaw istenen tool_choice değerini korur. Çok turlu araç kullanımında OpenClaw, Moonshot'ın yeniden oynatma sözleşmesinin gerektirdiği asistan akıl yürütme içeriğini korur.

    Kimi K2.7 Code her zaman yerel düşünmeyi kullanır. Moonshot, istemcilerin bu model için thinking alanını çıkarmasını gerektirir; bu nedenle OpenClaw yalnızca on sunar ve eski off ayarlarını yok sayar. K2.7 ayrıca temperature, top_p, n, presence_penalty ve frequency_penalty değerlerini sabitler; OpenClaw bu alanlar için yapılandırılmış geçersiz kılmaları çıkarır.

    Diğer Moonshot Kimi modelleri ikili yerel düşünmeyi destekler:

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

    Bunu model başına agents.defaults.models.<provider/model>.params üzerinden yapılandırın:

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

    OpenClaw, bu modeller için çalışma zamanı /think düzeylerini eşler:

    /think düzeyi Moonshot davranışı
    /think off thinking.type=disabled
    Kapalı dışındaki herhangi bir düzey thinking.type=enabled

    Kimi K2.6 ayrıca reasoning_content değerinin çok turlu korunmasını denetleyen isteğe bağlı bir thinking.keep alanını kabul eder. Turlar boyunca tam akıl yürütmeyi korumak için bunu "all" olarak ayarlayın; sunucunun varsayılan stratejisini kullanmak için alanı çıkartın (veya null olarak bırakın). OpenClaw, thinking.keep değerini yalnızca moonshot/kimi-k2.6 için iletir ve diğer modellerden kaldırır. Kimi K2.7 Code, varsayılan olarak tam akıl yürütme geçmişini korurken OpenClaw thinking alanının tamamını çıkarır.

    json5
    {  agents: {    defaults: {      models: {        "moonshot/kimi-k2.6": {          params: {            thinking: { type: "enabled", keep: "all" },          },        },      },    },  },}
    Araç çağrısı kimliği temizleme

    Moonshot Kimi, functions.<name>:<index> biçimindeki yerel tool_call kimliklerini sunar. OpenClaw, her yerel Kimi kimliğinin ilk örneğini korur ve sonraki yinelenenleri belirlenimci, OpenAI tarzı call_* kimlikleriyle yeniden yazar. Eşleşen araç sonuçları aynı kimlikle yeniden eşlenir; böylece Kimi'nin ilk yerel kimliği kaldırılmadan yeniden oynatma benzersiz kalır. Bu davranış, paketlenmiş Moonshot sağlayıcısına bağlıdır ve kullanıcı tarafından yapılandırılabilen bir ayar değildir.

    Akış kullanımı uyumluluğu

    Yerel Moonshot uç noktaları (https://api.moonshot.ai/v1 ve https://api.moonshot.cn/v1) akış kullanımı uyumluluğunu bildirir. OpenClaw bunu sağlayıcı kimliğine göre değil, uç nokta ana bilgisayarına göre belirler; dolayısıyla aynı yerel Moonshot ana bilgisayarına yönlendirilen özel bir sağlayıcı kimliği, aynı akış kullanımı davranışını devralır.

    Katalogdaki K2.6 fiyatlandırmasıyla; girdi, çıktı ve önbellekten okuma token'larını içeren akış kullanımı, /status, /usage full, /usage cost ve transkript destekli oturum muhasebesi için yerel tahmini USD maliyetine de dönüştürülür.

    Uç nokta ve model başvurusu referansı
    Sağlayıcı Model başvurusu ön eki Uç nokta Kimlik doğrulama ortam değişkeni
    Moonshot moonshot/ https://api.moonshot.ai/v1 MOONSHOT_API_KEY
    Moonshot CN moonshot/ https://api.moonshot.cn/v1 MOONSHOT_API_KEY
    Kimi Coding kimi/ Kimi Coding uç noktası KIMI_API_KEY
    Web araması Yok Moonshot API bölgesiyle aynı KIMI_API_KEY veya MOONSHOT_API_KEY
    • Kimi web araması KIMI_API_KEY veya MOONSHOT_API_KEY kullanır ve kimi-k2.6 modeliyle varsayılan olarak https://api.moonshot.ai/v1 değerini kullanır.
    • Gerekirse models.providers içindeki fiyatlandırma ve bağlam meta verilerini geçersiz kılın.
    • Moonshot bir model için farklı bağlam sınırları yayımlarsa contextWindow değerini buna göre ayarlayın.

    İlgili içerikler

    Model seçimi

    Sağlayıcıları, model başvurularını ve yük devretme davranışını seçme.
    Web araması

    Kimi dâhil web araması sağlayıcılarını yapılandırma.
    Yapılandırma referansı

    Sağlayıcılar, modeller ve Plugin'ler için tam yapılandırma şeması.
    Moonshot Open Platform

    Moonshot API anahtarı yönetimi ve belgeleri.
    Was this useful?
    On this page

    On this page