Moonshot AI (Kimi) を OpenClaw で使う方法

長いドキュメントを読み込ませたいのに、コンテキストウィンドウの制限でエラーが出て困ったことはありませんか？私も以前、膨大なログファイルを解析しようとして、どのモデルを使うべきか頭を抱えたことがあります。

そんな時に試してほしいのが Moonshot AI の Kimi です。OpenAI 互換の API を備えているので、既存のワークフローを大きく変えることなく導入できます。特に長文の扱いが得意なので、複雑なプロジェクトでも頼りになります。

必要なもの

セットアップを始める前に、以下の準備ができているか確認してください。

Moonshot API Key または Kimi Coding API Key
インストール済みの OpenClaw
Node.js 環境
API へのアクセス権限

クイックスタート

5分もあれば、Kimi を使い始めることができます。

まず、Moonshot API を設定するには、ターミナルで以下のコマンドを実行します。

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

コーディングに特化した Kimi Coding を使いたい場合は、こちらのコマンドを使ってください。

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

基本的には、最新の kimi-k2.5 をデフォルトモデルに設定するのが一番のおすすめです。レスポンスの質と速度のバランスが非常に優れています。

Config snippet (Moonshot API)

設定ファイル（config.json5）に直接記述する場合は、以下のコードをコピーして使ってください。API Key は自分のものに書き換えてくださいね。

{
  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-0905-preview",
            name: "Kimi K2 0905 Preview",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 8192,
          },
          {
            id: "kimi-k2-turbo-preview",
            name: "Kimi K2 Turbo",
            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,
          },
          {
            id: "kimi-k2-thinking-turbo",
            name: "Kimi K2 Thinking Turbo",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

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 と Kimi Coding は別々の Provider です。Key に互換性はないので、正しい方の Key を使っているか確認してください。
接続が遅い: 利用する場所に合わせて baseUrl を使い分けてください。国際版なら https://api.moonshot.ai/v1、中国国内からなら https://api.moonshot.cn/v1 が適しています。
モデルが見つからない: モデル名のプレフィックスに注意してください。Moonshot は moonshot/、Kimi Coding は kimi-coding/ を付ける必要があります。
コンテキストエラー: モデルごとに contextWindow の上限が異なります。公式の最新情報を確認して設定値を調整してください。

設定で困ったことがあれば、いつでも AI Setup Assistant に相談してください。

次のステップ

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。