Providers

Moonshot AI

Moonshot menyediakan API Kimi dengan endpoint yang kompatibel dengan OpenAI. Konfigurasikan provider dan setel model default ke moonshot/kimi-k2.6, atau gunakan Kimi Coding dengan kimi/kimi-code.

Katalog model bawaan

Model ref	Nama	Reasoning	Input	Context	Output maks
`moonshot/kimi-k2.6`	Kimi K2.6	Tidak	text, image	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	Tidak	text, image	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	Ya	text	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	Ya	text	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	Tidak	text	256,000	16,384

Estimasi biaya bawaan untuk model K2 yang saat ini di-host Moonshot menggunakan tarif pay-as-you-go yang dipublikasikan Moonshot: Kimi K2.6 adalah $0.16/MTok cache hit, $0.95/MTok input, dan $4.00/MTok output; Kimi K2.5 adalah $0.10/MTok cache hit, $0.60/MTok input, dan $3.00/MTok output. Entri katalog lama lainnya tetap menggunakan placeholder biaya nol kecuali Anda menggantinya di config.

Memulai

Pilih provider Anda dan ikuti langkah penyiapannya.

Moonshot API

Terbaik untuk: model Kimi K2 melalui Moonshot Open Platform.

Pilih region endpoint Anda

Pilihan auth	Endpoint	Region
`moonshot-api-key`	`https://api.moonshot.ai/v1`	Internasional
`moonshot-api-key-cn`	`https://api.moonshot.cn/v1`	China

Jalankan onboarding

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

Atau untuk endpoint China:

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

Setel model default

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

Verifikasi bahwa model tersedia

openclaw models list --provider moonshot

Jalankan 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 beserta estimasi biaya di bawah usage.cost saat Moonshot mengembalikan metadata penggunaan.

Contoh config

{
  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

Terbaik untuk: tugas yang berfokus pada kode melalui endpoint Kimi Coding.

Jalankan onboarding

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

Setel model default

{
  agents: {
    defaults: {
      model: { primary: "kimi/kimi-code" },
    },
  },
}

Verifikasi bahwa model tersedia

openclaw models list --provider kimi

Contoh config

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

Pencarian web Kimi

OpenClaw juga menyediakan Kimi sebagai provider web_search, yang didukung oleh pencarian web Moonshot.

Jalankan penyiapan pencarian web interaktif

openclaw configure --section web

Pilih Kimi di bagian web-search untuk menyimpan plugins.entries.moonshot.config.webSearch.*.

Konfigurasikan region pencarian web dan model

Penyiapan interaktif akan meminta:

Pengaturan	Opsi
Region API	`https://api.moonshot.ai/v1` (internasional) atau `https://api.moonshot.cn/v1` (China)
Model pencarian web	Default ke `kimi-k2.6`

Config berada di bawah plugins.entries.moonshot.config.webSearch:

{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // atau gunakan KIMI_API_KEY / MOONSHOT_API_KEY
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.6",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

Konfigurasi lanjutan

Mode thinking native

Moonshot Kimi 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 juga memetakan level runtime /think untuk Moonshot:

Level `/think`	Perilaku Moonshot
`/think off`	`thinking.type=disabled`
Level non-off apa pun	`thinking.type=enabled`

Kimi K2.6 juga menerima field opsional thinking.keep yang mengontrol retensi multi-turn dari reasoning_content. Setel ke "all" untuk menyimpan seluruh reasoning di semua turn; 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" },
          },
        },
      },
    },
  },
}

Sanitisasi id pemanggilan tool

Moonshot Kimi menyajikan id tool_call berbentuk seperti functions.<name>:<index>. OpenClaw mempertahankannya apa adanya agar pemanggilan tool multi-turn tetap berfungsi.

Untuk memaksa sanitisasi ketat pada provider kustom yang kompatibel dengan OpenAI, setel sanitizeToolCallIds: true:

{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}

Kompatibilitas penggunaan streaming

Endpoint Moonshot native (https://api.moonshot.ai/v1 dan https://api.moonshot.cn/v1) mengiklankan kompatibilitas penggunaan streaming pada transport bersama openai-completions. OpenClaw mengaitkannya dengan kapabilitas endpoint, sehingga id provider kustom yang kompatibel dan menargetkan host Moonshot native yang sama mewarisi perilaku streaming-usage yang sama.

Dengan harga K2.6 bawaan, penggunaan streaming yang mencakup token input, output, dan cache-read juga dikonversi menjadi estimasi biaya USD lokal untuk /status, /usage full, /usage cost, dan akuntansi sesi berbasis transkrip.

Referensi endpoint dan model ref

Provider	Prefix model ref	Endpoint	Variabel env auth
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`
Web search	N/A	Sama seperti region API Moonshot	`KIMI_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.
Ganti metadata harga dan context di models.providers jika diperlukan.
Jika Moonshot memublikasikan batas context yang berbeda untuk suatu model, sesuaikan contextWindow sebagaimana mestinya.

Terkait

Pemilihan model

Memilih provider, model ref, dan perilaku failover.

Pencarian web

Mengonfigurasi provider pencarian web termasuk Kimi.

Referensi konfigurasi

Skema config lengkap untuk provider, model, dan plugin.

Moonshot Open Platform

Pengelolaan API key dan dokumentasi Moonshot.

# Katalog model bawaan

# Memulai

Moonshot API

Pilih region endpoint Anda

Jalankan onboarding

Setel model default

Verifikasi bahwa model tersedia

Jalankan live smoke test

# Contoh config

Kimi Coding

Jalankan onboarding

Setel model default

Verifikasi bahwa model tersedia

# Contoh config

# Pencarian web Kimi

Jalankan penyiapan pencarian web interaktif

Konfigurasikan region pencarian web dan model

# Konfigurasi lanjutan

# Terkait

Katalog model bawaan

Memulai

Contoh config

Contoh config

Pencarian web Kimi

Konfigurasi lanjutan

Terkait