Langsung ke konten utama
Moonshot menyediakan Kimi API dengan endpoint yang kompatibel dengan OpenAI. Konfigurasikan penyedia dan tetapkan model default ke moonshot/kimi-k2.6, atau gunakan Kimi Coding dengan kimi/kimi-for-coding.
Moonshot dan Kimi Coding adalah penyedia terpisah. Kunci tidak dapat dipertukarkan, endpoint berbeda, dan referensi model berbeda (moonshot/... vs kimi/...).

​
Katalog model bawaan

Referensi modelNamaPenalaranInputKonteksOutput maks
moonshot/kimi-k2.6Kimi K2.6Tidakteks, gambar262,144262,144
moonshot/kimi-k2.7-codeKimi K2.7 CodeSelalu aktifteks, gambar262,144262,144
moonshot/kimi-k2.5Kimi K2.5Tidakteks, gambar262,144262,144
moonshot/kimi-k2-thinkingKimi K2 ThinkingYateks262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking TurboYateks262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboTidakteks256,00016,384
Estimasi biaya katalog untuk model K2 saat ini yang di-host Moonshot menggunakan tarif bayar sesuai pemakaian yang diterbitkan Moonshot: Kimi K2.7 Code adalah 0.19/MTokcachehit,0.19/MTok cache hit, 0.95/MTok input, dan 4.00/MTokoutput;KimiK2.6adalah4.00/MTok output; Kimi K2.6 adalah 0.16/MTok cache hit, 0.95/MTokinput,dan0.95/MTok input, dan 4.00/MTok output; Kimi K2.5 adalah 0.10/MTokcachehit,0.10/MTok cache hit, 0.60/MTok input, dan $3.00/MTok output. Entri katalog lama lainnya mempertahankan placeholder tanpa biaya kecuali Anda menimpanya di konfigurasi. Kimi K2.7 Code selalu menggunakan thinking native. OpenClaw hanya mengekspos status thinking on untuk model ini dan menghilangkan kontrol keluar thinking dan reasoning_effort, seperti yang diwajibkan Moonshot. OpenClaw juga menghilangkan override sampling yang dikunci K2.7 ke default penyedia. Kimi K2.6 tetap menjadi default onboarding.

​
Memulai

Pilih penyedia Anda dan ikuti langkah penyiapan.
Terbaik untuk: model Kimi K2 melalui Moonshot Open Platform.
1

Choose your endpoint region

Pilihan authEndpointWilayah
moonshot-api-keyhttps://api.moonshot.ai/v1Internasional
moonshot-api-key-cnhttps://api.moonshot.cn/v1Tiongkok
2

Run onboarding

openclaw onboard --auth-choice moonshot-api-key
Atau untuk endpoint Tiongkok:
openclaw onboard --auth-choice moonshot-api-key-cn
3

Set a default model

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

Verify models are available

openclaw models list --provider moonshot
5

Run a live smoke test

Gunakan direktori state terisolasi saat Anda ingin memverifikasi akses model dan pelacakan biaya tanpa menyentuh sesi normal Anda:
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
Respons JSON seharusnya melaporkan provider: "moonshot" dan model: "kimi-k2.6". Entri transkrip asisten menyimpan penggunaan token yang dinormalisasi ditambah estimasi biaya di bawah usage.cost saat Moonshot mengembalikan metadata penggunaan.

​
Contoh konfigurasi

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

​
Pencarian web Kimi

Plugin Moonshot juga mendaftarkan Kimi sebagai penyedia web_search, yang didukung oleh pencarian web Moonshot.
1

Run interactive web search setup

openclaw configure --section web
Pilih Kimi di bagian pencarian web untuk menyimpan plugins.entries.moonshot.config.webSearch.*.
2

Configure the web search region and model

Penyiapan interaktif meminta:
PengaturanOpsi
Wilayah APIhttps://api.moonshot.ai/v1 (internasional) atau https://api.moonshot.cn/v1 (Tiongkok)
Model pencarian webDefault ke kimi-k2.6
Konfigurasi berada di bawah 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",
      },
    },
  },
}

​
Konfigurasi lanjutan

Kimi K2.7 Code selalu menggunakan mode thinking native. Moonshot mewajibkan klien untuk menghilangkan field thinking untuk model ini, sehingga OpenClaw hanya mengekspos on dan mengabaikan pengaturan off yang usang. K2.7 juga mengunci temperature, top_p, n, presence_penalty, dan frequency_penalty; OpenClaw menghilangkan override yang dikonfigurasi untuk field tersebut.Model Moonshot Kimi lainnya mendukung thinking native biner:
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
Konfigurasikan per model melalui agents.defaults.models.<provider/model>.params:
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
OpenClaw memetakan level /think runtime untuk model tersebut:
Level /thinkPerilaku Moonshot
/think offthinking.type=disabled
Level non-off apa punthinking.type=enabled
Saat thinking Moonshot diaktifkan, tool_choice harus berupa auto atau none. OpenClaw menormalisasi nilai yang tidak kompatibel menjadi auto. Ini termasuk Kimi K2.7 Code, yang mode thinking-nya tidak dapat dinonaktifkan untuk mempertahankan pilihan alat yang dipasangi pin.
Kimi K2.6 juga menerima field opsional thinking.keep yang mengontrol retensi multi-giliran untuk reasoning_content. Atur ke "all" untuk mempertahankan reasoning lengkap di seluruh giliran; hilangkan (atau biarkan null) untuk menggunakan strategi default server. OpenClaw hanya meneruskan thinking.keep untuk moonshot/kimi-k2.6 dan menghapusnya dari model lain. Kimi K2.7 Code mempertahankan riwayat reasoning lengkap secara default sementara OpenClaw menghilangkan seluruh field thinking.
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
Moonshot Kimi menyajikan id tool_call native berbentuk functions.<name>:<index>. Untuk transport OpenAI-completions, OpenClaw mempertahankan kemunculan pertama dari setiap id Kimi native dan menulis ulang duplikat berikutnya menjadi id call_* bergaya OpenAI yang deterministik. Hasil tool yang cocok dipetakan ulang dengan id yang sama sehingga replay tetap unik tanpa menghapus id native pertama Kimi.Untuk memaksakan sanitisasi ketat pada penyedia kustom yang kompatibel dengan OpenAI, atur sanitizeToolCallIds: true:
{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}
Endpoint Moonshot native (https://api.moonshot.ai/v1 dan https://api.moonshot.cn/v1) menyatakan kompatibilitas penggunaan streaming pada transport openai-completions bersama. OpenClaw menentukannya berdasarkan kapabilitas endpoint, sehingga id penyedia kustom yang kompatibel dan menargetkan host Moonshot native yang sama mewarisi perilaku penggunaan streaming yang sama.Dengan harga K2.6 katalog, penggunaan streaming yang menyertakan token input, output, dan cache-read juga dikonversi menjadi estimasi biaya USD lokal untuk /status, /usage full, /usage cost, dan akuntansi sesi berbasis transkrip.
PenyediaPrefiks model refEndpointVariabel env auth
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Endpoint Kimi CodingKIMI_API_KEY
Pencarian webN/ASama dengan wilayah Moonshot APIKIMI_API_KEY atau MOONSHOT_API_KEY
  • Pencarian web Kimi menggunakan KIMI_API_KEY atau MOONSHOT_API_KEY, dan default ke https://api.moonshot.ai/v1 dengan model kimi-k2.6.
  • Timpa harga dan metadata konteks di models.providers jika diperlukan.
  • Jika Moonshot menerbitkan batas konteks berbeda untuk suatu model, sesuaikan contextWindow.

​
Terkait

Pemilihan model

Memilih penyedia, model ref, dan perilaku failover.

Pencarian web

Mengonfigurasi penyedia pencarian web termasuk Kimi.

Referensi konfigurasi

Skema konfigurasi lengkap untuk penyedia, model, dan plugin.

Moonshot Open Platform

Manajemen kunci Moonshot API dan dokumentasi.