Providers

月之暗面 AI

Moonshot 提供具有 OpenAI 相容端點的 Kimi API。若使用 Moonshot Open Platform,請將預設模型設為 moonshot/kimi-k2.6;若使用 Kimi Coding,則設為 kimi/kimi-for-coding

內建模型目錄

模型參照 名稱 推理 輸入 上下文 最大輸出
moonshot/kimi-k2.6 Kimi K2.6 文字、圖片 262,144 262,144
moonshot/kimi-k2.7-code Kimi K2.7 Code 永遠啟用 文字、圖片 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 公布的隨用隨付費率:Kimi K2.7 Code 的快取命中費用為每百萬權杖 $0.19、輸入為每百萬權杖 $0.95、輸出為每百萬權杖 $4.00;Kimi K2.6 的快取命中費用為每百萬權杖 $0.16、輸入為每百萬權杖 $0.95、輸出為每百萬權杖 $4.00;Kimi K2.5 的快取命中費用為每百萬權杖 $0.10、輸入為每百萬權杖 $0.60、輸出為每百萬權杖 $3.00。除非你在設定中覆寫,否則目錄中的其他項目會保留零成本預留值。

Kimi K2.7 Code 一律使用原生思考。依照 Moonshot 的要求,OpenClaw 對此模型只公開 on 思考狀態,且不會送出 thinkingreasoning_effort 欄位。它也會省略取樣覆寫值(temperaturetop_pnpresence_penaltyfrequency_penalty),因為 K2.7 會將這些值固定為提供者的預設值。Kimi K2.6 仍是初始設定流程的預設模型。

開始使用

Moonshot 與 Kimi Coding 都是外部外掛,請先安裝其中一個,再進行初始設定。

Moonshot API

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

  • Install the plugin

    bash
    openclaw plugins install @openclaw/moonshot-provideropenclaw gateway restart
  • Choose your endpoint region

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

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

    或使用中國端點:

    bash
    openclaw onboard --auth-choice moonshot-api-key-cn
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "moonshot/kimi-k2.6" },    },  },}
  • Verify models are available

    bash
    openclaw models list --provider moonshot
  • Run a live smoke test

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

    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 off \  --json

    JSON 回應應回報 provider: "moonshot"model: "kimi-k2.6"。當 Moonshot 傳回使用量中繼資料時,助理逐字稿項目會在 usage.cost 下儲存正規化後的權杖使用量與預估成本。

  • 設定範例

    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-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 Coding

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

  • Install the plugin

    bash
    openclaw plugins install @openclaw/kimi-provideropenclaw gateway restart
  • Run onboarding

    bash
    openclaw onboard --auth-choice kimi-code-api-key
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "kimi/kimi-for-coding" },    },  },}
  • Verify the model is available

    bash
    openclaw models list --provider kimi
  • 設定範例

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

    Kimi 網路搜尋

    Moonshot 外掛也會將由 Moonshot 網路搜尋支援的 Kimi 註冊為 web_search 提供者。

  • Run interactive web search setup

    bash
    openclaw configure --section web

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

  • Configure the web search region and model

    互動式設定會提示你選擇:

    設定 選項
    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",      },    },  },}

    進階設定

    Native thinking mode

    Kimi K2.7 Code 一律使用原生思考。Moonshot 要求用戶端對此模型省略 thinking 欄位,因此 OpenClaw 只公開 on,並忽略過時的 off 設定。K2.7 也會固定 temperaturetop_pnpresence_penaltyfrequency_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 提供的原生 tool_call ID 格式為 functions.<name>:<index>。OpenClaw 會保留每個原生 Kimi ID 第一次出現的值,並將後續重複項目改寫為確定性的 OpenAI 風格 call_* ID。相符的工具結果會使用相同 ID 重新對應,因此重播時仍能維持唯一性,同時不移除 Kimi 首次出現的原生 ID。此行為已整合至隨附的 Moonshot 提供者,並非使用者可設定的選項。

    串流用量相容性

    原生 Moonshot 端點(https://api.moonshot.ai/v1https://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_KEYMOONSHOT_API_KEY
    • Kimi 網頁搜尋使用 KIMI_API_KEYMOONSHOT_API_KEY,預設端點為 https://api.moonshot.ai/v1,模型為 kimi-k2.6
    • 如有需要,請在 models.providers 中覆寫定價和內容脈絡中繼資料。
    • 如果 Moonshot 為某個模型公布不同的內容脈絡限制,請相應調整 contextWindow

    相關內容

    Was this useful?
    On this page

    On this page