跳轉到主要內容
Moonshot 提供具備 OpenAI 相容端點的 Kimi API。若使用 Moonshot Open Platform，請將預設模型設為 moonshot/kimi-k2.6；若使用 Kimi Coding，請設為 kimi/kimi-for-coding。
Moonshot 和 Kimi Coding 是不同的提供者，各自以獨立的外部外掛發佈。金鑰不可互用，端點不同，模型參照也不同（moonshot/... 與 kimi/...）。

​
內建模型目錄

模型參照名稱推理輸入上下文最大輸出
moonshot/kimi-k2.6Kimi K2.6否文字、圖片262,144262,144
moonshot/kimi-k2.7-codeKimi K2.7 Code永遠開啟文字、圖片262,144262,144
moonshot/kimi-k2.5Kimi K2.5否文字、圖片262,144262,144
moonshot/kimi-k2-thinkingKimi K2 Thinking是文字262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking Turbo是文字262,144262,144
moonshot/kimi-k2-turboKimi K2 Turbo否文字256,00016,384
目錄成本估算使用 Moonshot 公布的隨用隨付費率：Kimi K2.7 Code 為快取命中 0.19/MTok、輸入0.19/MTok、輸入 0.95/MTok、輸出 4.00/MTok；KimiK2.6為快取命中4.00/MTok；Kimi K2.6 為快取命中 0.16/MTok、輸入 0.95/MTok、輸出0.95/MTok、輸出 4.00/MTok；Kimi K2.5 為快取命中 0.10/MTok、輸入0.10/MTok、輸入 0.60/MTok、輸出 $3.00/MTok。除非你在設定中覆寫，其他目錄項目會保留零成本佔位值。 Kimi K2.7 Code 一律使用原生 thinking。依 Moonshot 要求，OpenClaw 對此模型只公開 on thinking 狀態，並省略傳出的 thinking 與 reasoning_effort 欄位。它也會省略取樣覆寫（temperature、top_p、n、presence_penalty、frequency_penalty），因為 K2.7 會將這些固定為提供者預設值。Kimi K2.6 仍是初始設定預設值。

​
開始使用

Moonshot 和 Kimi Coding 都是外部外掛；請在初始設定前先安裝其中一個。
最適合： 透過 Moonshot Open Platform 使用 Kimi K2 模型。
1

安裝外掛

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

選擇你的端點區域

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

執行初始設定

openclaw onboard --auth-choice moonshot-api-key
或使用中國端點：
openclaw onboard --auth-choice moonshot-api-key-cn
4

設定預設模型

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

確認模型可用

openclaw models list --provider moonshot
6

執行即時煙霧測試

若你想在不影響一般工作階段的情況下驗證模型存取與成本追蹤，請使用隔離的狀態目錄：
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 回傳用量中繼資料時，助理轉錄項目會在 usage.cost 下儲存標準化的權杖用量與估算成本。

​
設定範例

{
  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.7-code": { alias: "Kimi K2.7 Code" },
        "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.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.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 網頁搜尋

Moonshot 外掛也會將 Kimi 註冊為 web_search 提供者，底層使用 Moonshot 網頁搜尋。
1

執行互動式網頁搜尋設定

openclaw configure --section web
在網頁搜尋區段中選擇 Kimi，以儲存 plugins.entries.moonshot.config.webSearch.*。
2

設定網頁搜尋區域與模型

互動式設定會提示：
設定選項
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",
      },
    },
  },
}

​
進階設定

Kimi K2.7 Code 一律使用原生 thinking。Moonshot 要求用戶端對此模型省略 thinking 欄位，因此 OpenClaw 只公開 on，並忽略過時的 off 設定。K2.7 也會固定 temperature、top_p、n、presence_penalty 與 frequency_penalty；OpenClaw 會省略這些欄位的已設定覆寫。其他 Moonshot Kimi 模型支援二元原生 thinking：
  • 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 offthinking.type=disabled
任何非 off 等級thinking.type=enabled
啟用 Moonshot thinking 時，tool_choice 必須是 auto 或 none。釘選的工具選擇（type: "tool" 或 type: "function"）會改為強制將 thinking 退回 disabled，讓要求的工具仍可執行；tool_choice: "required" 則會改為標準化為 auto。這適用於除 Kimi K2.7 Code 以外的所有 Moonshot 模型；Kimi K2.7 Code 的 thinking 模式無法停用，因此在不相容時，其 tool_choice 會標準化為 auto。
Kimi K2.6 也接受選用的 thinking.keep 欄位，用來控制 reasoning_content 的多輪保留。將其設為 "all" 可在多輪之間保留完整 reasoning；省略它（或保留為 null）則使用伺服器 預設策略。OpenClaw 只會針對 moonshot/kimi-k2.6 轉送 thinking.keep，並會從其他模型移除它。Kimi K2.7 Code 預設會保留完整 reasoning 歷史，而 OpenClaw 會省略整個 thinking 欄位。
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
Moonshot Kimi 提供形如 functions.<name>:<index> 的原生 tool_call ID。OpenClaw 會保留每個原生 Kimi ID 的第一次出現，並將後續重複項改寫為確定性的 OpenAI 風格 call_* ID。相符的工具結果會以相同 ID 重新對應，因此重播時仍保持唯一性，同時不會移除 Kimi 第一個原生 ID。此行為已接入內建的 Moonshot 供應商，並不是使用者可設定的選項。
原生 Moonshot 端點（https://api.moonshot.ai/v1 和 https://api.moonshot.cn/v1）會宣告串流用量相容性。 OpenClaw 會根據端點主機判定此行為，而不是根據供應商 ID，因此指向相同原生 Moonshot 主機的自訂 供應商 ID 會繼承相同的 串流用量行為。使用目錄中的 K2.6 定價時，包含輸入、輸出 和快取讀取 token 的串流用量，也會轉換為本機估算的美元成本，用於 /status、/usage full、/usage cost，以及以 transcript 為基礎的工作階段 帳務統計。
供應商模型參照前綴端點驗證環境變數
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Kimi Coding 端點KIMI_API_KEY
網頁搜尋N/A與 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 中覆寫定價和 context 中繼資料。
  • 如果 Moonshot 針對某個模型發布不同的 context 限制，請相應調整 contextWindow。

​
相關

模型選擇

選擇供應商、模型參照和容錯移轉行為。

網頁搜尋

設定包含 Kimi 在內的網頁搜尋供應商。

設定參考

供應商、模型和外掛的完整設定結構描述。

Moonshot Open Platform

Moonshot API 金鑰管理與文件。