Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 modelNamaPenalaranMasukanKonteksOutput maks
moonshot/kimi-k2.6Kimi K2.6Tidakteks, 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 yang dibundel untuk model K2 saat ini yang dihosting Moonshot menggunakan tarif bayar sesuai pemakaian yang diterbitkan Moonshot: Kimi K2.6 adalah 0.16/MTokcachehit,0.16/MTok cache hit, 0.95/MTok input, dan 4.00/MTokoutput;KimiK2.5adalah4.00/MTok output; Kimi K2.5 adalah 0.10/MTok cache hit, 0.60/MTokinput,dan0.60/MTok input, dan 3.00/MTok output. Entri katalog lama lainnya mempertahankan nilai pengganti biaya nol kecuali Anda menimpanya di konfigurasi.

Memulai

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

Pilih wilayah endpoint Anda

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

Jalankan onboarding

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

Tetapkan model default

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

Pastikan model tersedia

openclaw models list --provider moonshot
5

Jalankan uji smoke langsung

Gunakan direktori status 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 harus melaporkan provider: "moonshot" dan model: "kimi-k2.6". Entri transkrip asisten menyimpan penggunaan token yang dinormalisasi plus 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.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
        ],
      },
    },
  },
}

Pencarian web Kimi

OpenClaw juga menyertakan Kimi sebagai penyedia web_search, yang didukung oleh pencarian web Moonshot.
1

Jalankan penyiapan pencarian web interaktif

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

Konfigurasikan wilayah dan model pencarian web

Penyiapan interaktif meminta:
PengaturanOpsi
Wilayah APIhttps://api.moonshot.ai/v1 (internasional) atau https://api.moonshot.cn/v1 (China)
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

Moonshot Kimi mendukung berpikir 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 juga memetakan level /think saat berjalan untuk Moonshot:
level /thinkPerilaku Moonshot
/think offthinking.type=disabled
Level apa pun selain offthinking.type=enabled
Saat thinking Moonshot diaktifkan, tool_choice harus berupa auto atau none. OpenClaw menormalkan nilai tool_choice yang tidak kompatibel menjadi auto demi kompatibilitas.
Kimi K2.6 juga menerima bidang opsional thinking.keep yang mengontrol retensi multi-giliran untuk reasoning_content. Atur ke "all" untuk mempertahankan penalaran penuh 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.
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
Moonshot Kimi menyajikan id tool_call berbentuk functions.<name>:<index>. OpenClaw mempertahankannya tanpa perubahan agar panggilan alat multi-giliran tetap berfungsi.Untuk memaksa sanitasi ketat pada penyedia khusus 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) mengiklankan kompatibilitas penggunaan streaming pada transport bersama openai-completions. OpenClaw menentukannya berdasarkan kemampuan endpoint, sehingga id penyedia khusus yang kompatibel yang menargetkan host Moonshot native yang sama mewarisi perilaku penggunaan streaming yang sama.Dengan harga K2.6 bawaan, penggunaan streaming yang mencakup token input, output, dan pembacaan cache juga dikonversi menjadi estimasi biaya USD lokal untuk /status, /usage full, /usage cost, dan akuntansi sesi berbasis transkrip.
PenyediaPrefiks ref modelEndpointVariabel env autentikasi
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 seperti wilayah API MoonshotKIMI_API_KEY atau MOONSHOT_API_KEY
  • Pencarian web Kimi menggunakan KIMI_API_KEY atau MOONSHOT_API_KEY, dan secara default menggunakan https://api.moonshot.ai/v1 dengan model kimi-k2.6.
  • Timpa metadata harga dan konteks di models.providers jika diperlukan.
  • Jika Moonshot memublikasikan batas konteks yang berbeda untuk sebuah model, sesuaikan contextWindow sebagaimana mestinya.

Terkait

Pemilihan model

Memilih penyedia, ref model, dan perilaku failover.

Pencarian web

Mengonfigurasi penyedia pencarian web termasuk Kimi.

Referensi konfigurasi

Skema konfigurasi lengkap untuk penyedia, model, dan plugin.

Moonshot Open Platform

Pengelolaan kunci API Moonshot dan dokumentasi.