跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Moonshot 提供具有 OpenAI 相容端點的 Kimi API。設定 provider，並將預設模型設為 moonshot/kimi-k2.6，或搭配 kimi/kimi-code 使用 Kimi Coding。
Moonshot 和 Kimi Coding 是不同的 providers。金鑰不可互換，端點不同，模型參照也不同（moonshot/... 與 kimi/...）。

​
內建模型目錄

模型參照名稱推理輸入上下文最大輸出
moonshot/kimi-k2.6Kimi K2.6否文字, 影像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 託管的 K2 模型所附帶的成本估算，使用 Moonshot 發布的隨用隨付費率：Kimi K2.6 為快取命中每 MTok 0.16、輸入每MTok0.16、 輸入每 MTok 0.95，以及輸出每 MTok 4.00；KimiK2.5為快取命中每MTok4.00；Kimi K2.5 為快取命中每 MTok 0.10、 輸入每 MTok 0.60，以及輸出每MTok0.60，以及輸出每 MTok 3.00。其他舊版目錄項目會保留 零成本預留值，除非你在設定中覆寫它們。

​
開始使用

選擇你的 provider，並依照設定步驟操作。
最適合： 透過 Moonshot Open Platform 使用 Kimi K2 模型。
1

Choose your endpoint region

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

Run onboarding

openclaw onboard --auth-choice moonshot-api-key
或針對中國端點：
openclaw onboard --auth-choice moonshot-api-key-cn
3

Set a default model

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

Verify models are available

openclaw models list --provider moonshot
5

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 網路搜尋

OpenClaw 也隨附 Kimi 作為 web_search provider，由 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",
      },
    },
  },
}

​
進階設定

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 offthinking.type=disabled
任何非 off 層級thinking.type=enabled
啟用 Moonshot 思考時，tool_choice 必須是 auto 或 none。OpenClaw 會將不相容的 tool_choice 值正規化為 auto，以確保相容性。
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" },
          },
        },
      },
    },
  },
}
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 支援的工作階段 帳務統計。
提供者模型參照前綴端點驗證環境變數
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/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 在內的網頁搜尋提供者。

設定參考

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

Moonshot Open Platform

Moonshot API 金鑰管理與文件。