快速串接 Moonshot AI (Kimi)：讓你的 AI 專案更有「人味」

我以前在串接各種 LLM 時，最煩的就是模型讀不懂長文，或者回覆太過生硬。自從試過 Moonshot 的 Kimi 後，我發現它在處理長文本和中文語境的理解上真的有一套。我記得第一次把一整份幾萬字的技術文件丟給它，它竟然能精準抓到重點，這點讓我印象深刻。

不過，剛開始接觸 Moonshot 的開發者常會被搞混，因為 Moonshot API 和 Kimi Coding 其實是兩個獨立的服務，API Key 和 Endpoint 都不通用。這篇文會幫你理清這些細節，讓你少走彎路。

需要準備的東西

• Moonshot 平台帳號（獲取 API Key）
• Kimi Coding 平台帳號（如果你需要寫程式增強版）
• 已安裝好的 Node.js 環境
• 你的終端機（Terminal）

快速開始

只要 5 分鐘，你就能把 Kimi 跑起來。Moonshot 的 API 跟 OpenAI 兼容，所以串接起來非常直覺。

1. 快速綁定 API Key

打開你的終端機，根據你想用的服務執行對應的指令：

使用 Moonshot 通用模型：

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

使用 Kimi Coding 模型：

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

2. 配置 Moonshot API

在你的配置文件中加入以下內容。這裡我們以 kimi-k2.5 作為預設模型，它目前在理解力與速度之間平衡得最好。

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.5" },
      models: {
        "moonshot/kimi-k2.5": { alias: "Kimi K2.5" },
        "moonshot/kimi-k2-0905-preview": { alias: "Kimi K2" },
        "moonshot/kimi-k2-turbo-preview": { alias: "Kimi K2 Turbo" },
        "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" },
        "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "kimi-k2.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 8192,
          },
          {
            id: "kimi-k2-thinking",
            name: "Kimi K2 Thinking",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 8192,
          }
        ],
      },
    },
  },
}

3. 配置 Kimi Coding (選配)

如果你需要更強的程式碼生成能力，可以另外配置 Kimi Coding：

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

疑難排解

在串接過程中，你可能會遇到這兩個常見的小坑：

• API Key 報錯：請檢查你的模型前綴。Moonshot 的模型必須用 moonshot/ 開頭，而 Kimi Coding 則是用 kimi-coding/。這兩者的 API Key 不能互換使用。
• 連線逾時：如果你在中國大陸境內開發，建議將 baseUrl 改為 https://api.moonshot.cn/v1；如果你在海外，則使用 https://api.moonshot.ai/v1 以獲得更好的連線速度。

如果你在設置過程中遇到任何奇怪的錯誤，隨時找我們的 AI Setup Assistant 聊聊，它能幫你快速檢查配置文件。

下一步

• 調整 Context Window：如果 Moonshot 之後更新了模型的上下文限制，你可以直接在 contextWindow 欄位修改。
• 自定義計費資訊：你可以在 models.providers 裡手動覆蓋 cost 參數，方便你追蹤預算。