Providers

Moonshot AI

Moonshot 提供具有 OpenAI 相容端點的 Kimi API。設定 provider，並將預設模型設為 moonshot/kimi-k2.6，或搭配 kimi/kimi-code 使用 Kimi Coding。

內建模型目錄

模型參照	名稱	推理	輸入	上下文	最大輸出
`moonshot/kimi-k2.6`	Kimi K2.6	否	文字, 影像	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	否	文字, 影像	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	是	文字	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	是	文字	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	否	文字	256,000	16,384

目前 Moonshot 託管的 K2 模型所附帶的成本估算，使用 Moonshot 發布的隨用隨付費率：Kimi K2.6 為快取命中每 MTok $0.16、輸入每 MTok $0.95，以及輸出每 MTok $4.00；Kimi K2.5 為快取命中每 MTok $0.10、輸入每 MTok $0.60，以及輸出每 MTok $3.00。其他舊版目錄項目會保留零成本預留值，除非你在設定中覆寫它們。

開始使用

選擇你的 provider，並依照設定步驟操作。

Moonshot API

最適合： 透過 Moonshot Open Platform 使用 Kimi K2 模型。

Choose your endpoint region

驗證選項	端點	區域
`moonshot-api-key`	`https://api.moonshot.ai/v1`	國際
`moonshot-api-key-cn`	`https://api.moonshot.cn/v1`	中國

Run onboarding

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

或針對中國端點：

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

Set a default model

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

Verify models are available

openclaw models list --provider moonshot

Run a live smoke test

當你想在不影響一般工作階段的情況下驗證模型存取與成本追蹤時，請使用隔離的狀態目錄：

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

JSON 回應應回報 provider: "moonshot" 與 model: "kimi-k2.6"。當 Moonshot 傳回使用量中繼資料時，assistant transcript 項目會在 usage.cost 下儲存正規化後的 token 使用量與估算成本。

設定範例

{
  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

最適合： 透過 Kimi Coding 端點執行著重程式碼的工作。

Run onboarding

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

Set a default model

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

Verify the model is available

openclaw models list --provider kimi

設定範例

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

Kimi 網路搜尋

OpenClaw 也隨附 Kimi 作為 web_search provider，由 Moonshot 網頁搜尋支援。

執行互動式網頁搜尋設定

openclaw configure --section web

在網頁搜尋區段中選擇 Kimi，以儲存 plugins.entries.moonshot.config.webSearch.*。

設定網頁搜尋區域和模型

互動式設定會提示：

設定	選項
API 區域	`https://api.moonshot.ai/v1`（國際）或 `https://api.moonshot.cn/v1`（中國）
網頁搜尋模型	預設為 `kimi-k2.6`

設定位於 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",
      },
    },
  },
}

進階設定

原生思考模式

Moonshot Kimi 支援二元原生思考：

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

透過 agents.defaults.models.<provider/model>.params 為每個模型設定：

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

OpenClaw 也會對 Moonshot 對應執行階段 /think 層級：

`/think` 層級	Moonshot 行為
`/think off`	`thinking.type=disabled`
任何非 off 層級	`thinking.type=enabled`

Kimi K2.6 也接受選用的 thinking.keep 欄位，用來控制 reasoning_content 的多輪保留。將它設為 "all" 可在多輪之間保留完整 reasoning；省略它（或將它保留為 null）則會使用伺服器預設策略。OpenClaw 只會為 moonshot/kimi-k2.6 轉送 thinking.keep，並會從其他模型中移除它。

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

工具呼叫 id 清理

Moonshot Kimi 提供形如 functions.<name>:<index> 的 tool_call ids。OpenClaw 會原樣保留它們，讓多輪工具呼叫持續正常運作。

若要在自訂的 OpenAI 相容 provider 上強制嚴格清理，請設定 sanitizeToolCallIds: true：

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

串流用量相容性

原生 Moonshot 端點（https://api.moonshot.ai/v1 和 https://api.moonshot.cn/v1）會在共用的 openai-completions transport 上宣告串流用量相容性。OpenClaw 會依端點 capabilities 判定，因此以相同原生 Moonshot 主機為目標的相容自訂 provider ids，會繼承相同的串流用量行為。

使用隨附的 K2.6 定價時，包含輸入、輸出、和快取讀取 token 的串流用量，也會轉換成本機估算 USD 成本，用於 /status、/usage full、/usage cost，以及由 transcript 支援的工作階段帳務統計。

端點與模型參照參考

提供者	模型參照前綴	端點	驗證環境變數
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 端點	`KIMI_API_KEY`
網頁搜尋	不適用	與 Moonshot API 區域相同	`KIMI_API_KEY` 或 `MOONSHOT_API_KEY`

Kimi 網頁搜尋使用 KIMI_API_KEY 或 MOONSHOT_API_KEY，並預設使用 https://api.moonshot.ai/v1 與模型 kimi-k2.6。
如有需要，請在 models.providers 中覆寫定價與上下文中繼資料。
如果 Moonshot 為某個模型發布不同的上下文限制，請相應調整 contextWindow。

Moonshot AI

內建模型目錄

開始使用

Moonshot API

Choose your endpoint region

Run onboarding

Set a default model

Verify models are available

Run a live smoke test

設定範例

Kimi Coding

Run onboarding

Set a default model

Verify the model is available

設定範例

Kimi 網路搜尋

執行互動式網頁搜尋設定

設定網頁搜尋區域和模型

進階設定

相關

Ask OpenClaw

# 內建模型目錄

# 開始使用

Moonshot API

Choose your endpoint region

Run onboarding

Set a default model

Verify models are available

Run a live smoke test

# 設定範例

Kimi Coding

Run onboarding

Set a default model

Verify the model is available

# 設定範例

# Kimi 網路搜尋

執行互動式網頁搜尋設定

設定網頁搜尋區域和模型

# 進階設定

# 相關

內建模型目錄

開始使用

設定範例

設定範例

Kimi 網路搜尋

進階設定

相關