月之暗面 AI

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

Moonshot 與 Kimi Coding 是不同的供應商，各自以獨立的外部外掛提供。金鑰不可互換、端點不同，模型參照也不同（moonshot/... 與 kimi/...）。

內建模型目錄

模型參照	名稱	推理	輸入	上下文	最大輸出
`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
Kimi Coding

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

安裝外掛

openclaw plugins install @openclaw/moonshot-provider
openclaw gateway restart

選擇端點區域

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

執行新手引導

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

或使用中國端點：

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

將 Kimi K3 設為預設模型

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

openclaw models set moonshot/kimi-k3

確認模型可用

openclaw models list --provider moonshot

執行即時冒煙測試

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

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 用量與估算成本。

設定範例

{
  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 使用的 API 金鑰與供應商前綴（kimi/...）不同於 Moonshot（moonshot/...）。目前的參照包括使用 256K 上下文的 kimi/k3、使用 1M 等級的 kimi/k3[1m]、kimi/kimi-for-coding 和 kimi/kimi-for-coding-highspeed。舊版參照 kimi/kimi-code 和 kimi/k2p5 仍可接受，並會正規化為 kimi/kimi-for-coding。

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

安裝外掛

openclaw plugins install @openclaw/kimi-provider
openclaw gateway restart

執行新手引導

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

設定預設模型

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

確認模型可用

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 模型表。

設定範例

{
  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 網頁搜尋。

執行互動式網頁搜尋設定

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 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 為各模型進行設定：

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

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

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

啟用 Moonshot K2 思考時，tool_choice 必須是 auto 或 none。固定工具選擇（type: "tool" 或 type: "function"）會改為強制將思考恢復成 disabled，以確保請求的工具仍會執行；tool_choice: "required" 則會改為正規化成 auto。Kimi K2.7 Code 無法停用思考，因此其不相容的 tool_choice 會正規化成 auto。Kimi K3 使用獨立的推理強度合約，並保留支援的工具選擇。

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

{
  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。

模型選擇

選擇提供者、模型參照及容錯移轉行為。

網頁搜尋

設定包括 Kimi 在內的網頁搜尋提供者。

設定參考

提供者、模型與外掛的完整設定結構描述。

Moonshot 開放平台

Moonshot API 金鑰管理與文件。

Overview

Concepts and configuration

Providers

內建模型目錄

開始使用

設定範例

設定範例

Kimi 網頁搜尋

進階設定

相關內容

模型選擇

網頁搜尋

設定參考

Moonshot 開放平台

​內建模型目錄

​開始使用

​設定範例

​設定範例

​Kimi 網頁搜尋

​進階設定

​相關內容

模型選擇

網頁搜尋

設定參考

Moonshot 開放平台

內建模型目錄

開始使用

設定範例

設定範例

Kimi 網頁搜尋

進階設定

相關內容