メインコンテンツへスキップ

​
Moonshot AI（Kimi）

Moonshot は OpenAI 互換エンドポイントを備えた Kimi API を提供します。provider を設定し、デフォルトモデルを moonshot/kimi-k2.5 に設定するか、kimi/kimi-code を使って Kimi Coding を使用します。
Moonshot と Kimi Coding は別々の providerです。キーに互換性はなく、エンドポイントも異なり、モデル参照も異なります（moonshot/... と kimi/...）。

​
組み込みモデルカタログ

モデル参照名前推論入力コンテキスト最大出力
moonshot/kimi-k2.5Kimi K2.5いいえtext, image262,144262,144
moonshot/kimi-k2-thinkingKimi K2 Thinkingはいtext262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking Turboはいtext262,144262,144
moonshot/kimi-k2-turboKimi K2 Turboいいえtext256,00016,384

​
はじめに

使用する provider を選び、セットアップ手順に従ってください。
最適な用途: Moonshot Open Platform 経由で Kimi K2 モデルを使う場合。
1

エンドポイントのリージョンを選ぶ

認証選択肢エンドポイントリージョン
moonshot-api-keyhttps://api.moonshot.ai/v1International
moonshot-api-key-cnhttps://api.moonshot.cn/v1China
2

オンボーディングを実行する

openclaw onboard --auth-choice moonshot-api-key
または China エンドポイントの場合:
openclaw onboard --auth-choice moonshot-api-key-cn
3

デフォルトモデルを設定する

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

モデルが利用可能であることを確認する

openclaw models list --provider moonshot

​
設定例

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.5" },
      models: {
        // moonshot-kimi-k2-aliases:start
        "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.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, 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
        ],
      },
    },
  },
}
OpenClaw には Kimi が web_search provider としても同梱されており、Moonshot web search をバックエンドとして使用します。
1

対話型 web search セットアップを実行する

openclaw configure --section web
web-search セクションで Kimi を選ぶと、 plugins.entries.moonshot.config.webSearch.* が保存されます。
2

web search のリージョンとモデルを設定する

対話セットアップでは次が表示されます。
設定選択肢
API リージョンhttps://api.moonshot.ai/v1（international）または https://api.moonshot.cn/v1（China）
Web search モデルデフォルトは kimi-k2.5
設定は plugins.entries.moonshot.config.webSearch 配下に保存されます。 
{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // または KIMI_API_KEY / MOONSHOT_API_KEY を使用
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.5",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

​
高度な内容

Moonshot Kimi はバイナリのネイティブ thinking をサポートします。
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
agents.defaults.models.<provider/model>.params でモデルごとに設定します。
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.5": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
OpenClaw は Moonshot に対してランタイムの /think レベルもマッピングします。
/think レベルMoonshot の動作
/think offthinking.type=disabled
off 以外の任意のレベルthinking.type=enabled
Moonshot thinking が有効な場合、tool_choice は auto または none である必要があります。OpenClaw は互換性のために、互換性のない tool_choice 値を auto に正規化します。
ネイティブ Moonshot エンドポイント（https://api.moonshot.ai/v1 と https://api.moonshot.cn/v1）は、共有の openai-completions トランスポートでストリーミング usage 互換性を公開しています。OpenClaw はそれをエンドポイント capability に基づいて判断するため、同じネイティブ Moonshot ホストを対象とする互換カスタム provider ID は、同じ streaming-usage 動作を引き継ぎます。
Providerモデル参照プレフィックスエンドポイントAuth 環境変数
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Kimi Coding endpointKIMI_API_KEY
Web searchN/AMoonshot API リージョンと同じKIMI_API_KEY または MOONSHOT_API_KEY
  • Kimi web search は KIMI_API_KEY または MOONSHOT_API_KEY を使用し、デフォルトは https://api.moonshot.ai/v1、モデルは kimi-k2.5 です。
  • 必要に応じて models.providers で料金やコンテキストのメタデータを上書きしてください。
  • Moonshot があるモデルについて異なるコンテキスト制限を公開した場合は、それに応じて contextWindow を調整してください。

​
関連

Model selection

provider、モデル参照、フェイルオーバー動作の選び方。

Web search

Kimi を含む web search provider の設定方法。

Configuration reference

provider、モデル、Plugin の完全な設定スキーマ。

Moonshot Open Platform

Moonshot API キー管理とドキュメント。