Providers

月之暗面 AI

Moonshot 透過相容於 OpenAI 的端點提供 Kimi API。為 Kimi K3 選取 moonshot/kimi-k3，保留新手引導預設值 moonshot/kimi-k2.6，或為 Kimi Coding 使用 kimi/kimi-for-coding。

內建模型目錄

模型參照	名稱	推理	輸入	上下文	最大輸出
`moonshot/kimi-k2.6`	Kimi K2.6	否	文字、圖片	262,144	262,144
`moonshot/kimi-k3`	Kimi K3	永遠最大	文字、圖片	1,048,576	1,048,576
`moonshot/kimi-k2.7-code`	Kimi K2.7 Code	永遠開啟	文字、圖片	262,144	262,144
`moonshot/kimi-k2.7-code-highspeed`	Kimi K2.7 Code HighSpeed	永遠開啟	文字、圖片	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	否	文字、圖片	262,144	262,144

目錄成本估算使用 Moonshot 公布的隨用隨付費率。在做出成本決策前，請查看 Kimi K3、 Kimi K2.7 Code、 Kimi K2.6 和 Kimi K2.5 的即時供應商頁面。

Kimi K3 永遠以 reasoning_effort: "max" 進行推理。OpenClaw 僅公開 /think max，省略僅限 K2 的 thinking 欄位，並移除 K3 固定為供應商預設值的取樣覆寫（temperature、top_p、n、presence_penalty 和 frequency_penalty）。Kimi K2.7 Code 也永遠使用原生思考，但要求同時省略 thinking 和 reasoning_effort；HighSpeed 變體使用相同的合約。 Kimi K2.6 仍是新手引導的預設值。請參閱 Moonshot 的 Kimi K3 快速入門。

開始使用

Moonshot 與 Kimi Coding 都是外部外掛——請先安裝其中一個，再進行新手引導。

Moonshot API

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

安裝外掛

bash

openclaw plugins install @openclaw/moonshot-provideropenclaw gateway restart

選擇端點區域

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

執行新手引導

bash

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

或使用中國端點：

bash

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

將 Kimi K3 設為預設模型

新手引導會保留 Kimi K2.6 作為初始預設值。想使用 Kimi K3 時，請明確切換：

bash

openclaw models set moonshot/kimi-k3

確認模型可用

bash

openclaw models list --provider moonshot

執行即時冒煙測試

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

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 回應應回報 provider: "moonshot" 和 model: "kimi-k3"。當 Moonshot 傳回用量中繼資料時，助理逐字稿項目會在 usage.cost 下儲存正規化的 Token 用量與估算成本。

設定範例

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

**最適合：**透過 Kimi Coding 端點執行以程式碼為主的工作。

此程式設計服務同時接受相容於 OpenAI 的 https://api.kimi.com/coding/v1 用戶端與相容於 Anthropic 的 https://api.kimi.com/coding/ 用戶端。此外掛使用 Anthropic Messages。請在 Kimi Code Console 建立會員金鑰；目前的會員定價請參閱 Kimi 定價頁面。

安裝外掛

bash

openclaw plugins install @openclaw/kimi-provideropenclaw gateway restart

執行新手引導

bash

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

設定預設模型

json5

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

確認模型可用

bash

openclaw models list --provider kimi

Kimi Code K3 預設在 max 使用深度思考。/think off 會傳送 thinking.type: "disabled"；/think max 會傳送 K3 的自適應思考請求，並使用最大推理強度。過時的較低思考等級會解析為受支援的 max 等級。1M 模型需要 Allegretto 或更高等級的 Kimi 會員資格；Moderato 請使用 kimi/k3。

如需目前方案的可用情況，請參閱官方 Kimi Code 模型表。

設定範例

json5

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

Kimi 網頁搜尋

Moonshot 外掛也會將 Kimi 註冊為 web_search 供應商，其後端使用 Moonshot 網頁搜尋。

執行互動式網頁搜尋設定

bash

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 下：

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

進階設定

原生思考模式

Moonshot API Kimi K3 永遠以最大推理強度進行推理。OpenClaw 僅公開 /think max、傳送 reasoning_effort: "max"，並忽略過時的較低等級或 off 設定。

Kimi Code K3 提供 /think off|max。其 Anthropic 相容端點會接收 thinking.type: "disabled" 以關閉思考，或使用自適應思考並透過 output_config.effort: "max" 設為最大值。這同時適用於 kimi/k3 與 kimi/k3[1m]。 Moonshot API K3 支援 auto、none、required 及固定工具選擇，因此 OpenClaw 會保留請求的 tool_choice。對於多輪工具使用， OpenClaw 會保留 Moonshot 重播合約所要求的助理推理內容。

Kimi K2.7 Code 一律使用原生思考。Moonshot 要求用戶端針對此模型省略 thinking 欄位，因此 OpenClaw 僅提供 on，並忽略過時的 off 設定。K2.7 也會固定 temperature、top_p、n、 presence_penalty 及 frequency_penalty；OpenClaw 會省略這些欄位已設定的覆寫值。

其他 Moonshot Kimi 模型支援二元原生思考：

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

透過 agents.defaults.models.<provider/model>.params 為各模型進行設定：

json5

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

OpenClaw 會為這些模型對應執行階段的 /think 等級：

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

Kimi K2.6 也接受選用的 thinking.keep 欄位，用於控制多輪對話中 reasoning_content 的保留方式。將其設為 "all"，即可跨輪保留完整推理；省略此欄位（或維持為 null）則會使用伺服器的預設策略。OpenClaw 僅會為 moonshot/kimi-k2.6 轉送 thinking.keep，並從其他模型中移除此欄位。Kimi K2.7 Code 預設會保留完整推理歷程，而 OpenClaw 會省略整個 thinking 欄位。

json5

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

工具呼叫 ID 清理

Moonshot Kimi 提供形如 functions.<name>:<index> 的原生 tool_call ID。OpenClaw 會保留每個原生 Kimi ID 的第一次出現，並將後續重複項目改寫為確定性的 OpenAI 風格 call_* ID。相符的工具結果會使用相同 ID 重新對應，因此無須移除 Kimi 的第一個原生 ID，也能確保重播時的 ID 唯一。此行為已整合至隨附的 Moonshot 提供者，並非使用者可設定的選項。

串流用量相容性

原生 Moonshot 端點（https://api.moonshot.ai/v1 與 https://api.moonshot.cn/v1）宣告支援串流用量相容性。 OpenClaw 依據端點主機而非提供者 ID 判斷，因此指向相同原生 Moonshot 主機的自訂提供者 ID 會繼承相同的串流用量行為。

使用目錄中的 K2.6 定價時，包含輸入、輸出與快取讀取權杖的串流用量，也會轉換為本機預估美元成本，供 /status、/usage full、/usage cost 及由逐字稿支援的工作階段計費使用。

端點與模型參照參考

提供者	模型參照前綴	端點	驗證環境變數
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。

本頁內容

月之暗面 AI

內建模型目錄

開始使用

Moonshot API

安裝外掛

選擇端點區域

執行新手引導

將 Kimi K3 設為預設模型

確認模型可用

執行即時冒煙測試

設定範例

Kimi Coding

安裝外掛

執行新手引導

設定預設模型

確認模型可用

設定範例

Kimi 網頁搜尋

執行互動式網頁搜尋設定

設定網頁搜尋區域與模型

進階設定

相關內容

Molty