Providers

Mistral

OpenClaw には、4 つのコントラクトを登録するバンドル済みの Mistral Plugin が含まれます: チャット補完、メディア理解 (Voxtral バッチ文字起こし)、音声通話向けリアルタイム STT (Voxtral Realtime)、メモリ埋め込み (mistral-embed) です。

プロパティ
プロバイダー ID mistral
Plugin バンドル済み、enabledByDefault: true
認証環境変数 MISTRAL_API_KEY
オンボーディングフラグ --auth-choice mistral-api-key
直接 CLI フラグ --mistral-api-key <key>
API OpenAI 互換 (openai-completions)
ベース URL https://api.mistral.ai/v1
デフォルトモデル mistral/mistral-large-latest
埋め込みモデル mistral-embed
Voxtral バッチ voxtral-mini-latest (音声文字起こし)
Voxtral リアルタイム voxtral-mini-transcribe-realtime-2602

はじめに

  • API キーを取得する

    Mistral Console で API キーを作成します。

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

    openclaw onboard --auth-choice mistral-api-key
    

    または、キーを直接渡します:

    openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
    
  • デフォルトモデルを設定する

    {
      env: { MISTRAL_API_KEY: "sk-..." },
      agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
    }
    
  • モデルが利用可能であることを確認する

    openclaw models list --provider mistral
    
  • 組み込み LLM カタログ

    OpenClaw には現在、このバンドル済み Mistral カタログが含まれます:

    モデル参照 入力 コンテキスト 最大出力 メモ
    mistral/mistral-large-latest テキスト、画像 262,144 16,384 デフォルトモデル
    mistral/mistral-medium-2508 テキスト、画像 262,144 8,192 Mistral Medium 3.1
    mistral/mistral-small-latest テキスト、画像 128,000 16,384 Mistral Small 4; API reasoning_effort による調整可能な推論
    mistral/pixtral-large-latest テキスト、画像 128,000 32,768 Pixtral
    mistral/codestral-latest テキスト 256,000 4,096 コーディング
    mistral/devstral-medium-latest テキスト 262,144 32,768 Devstral 2
    mistral/magistral-small テキスト 128,000 40,000 推論対応

    音声文字起こし (Voxtral)

    メディア理解パイプラインを通じたバッチ音声文字起こしには Voxtral を使用します。

    {
      tools: {
        media: {
          audio: {
            enabled: true,
            models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
          },
        },
      },
    }
    

    音声通話ストリーミング STT

    バンドル済みの mistral Plugin は、Voxtral Realtime を音声通話ストリーミング STT プロバイダーとして登録します。

    設定 設定パス デフォルト
    API キー plugins.entries.voice-call.config.streaming.providers.mistral.apiKey MISTRAL_API_KEY にフォールバック
    モデル ...mistral.model voxtral-mini-transcribe-realtime-2602
    エンコーディング ...mistral.encoding pcm_mulaw
    サンプルレート ...mistral.sampleRate 8000
    目標遅延 ...mistral.targetStreamingDelayMs 800
    {
      plugins: {
        entries: {
          "voice-call": {
            config: {
              streaming: {
                enabled: true,
                provider: "mistral",
                providers: {
                  mistral: {
                    apiKey: "${MISTRAL_API_KEY}",
                    targetStreamingDelayMs: 800,
                  },
                },
              },
            },
          },
        },
      },
    }
    

    高度な設定

    調整可能な推論 (mistral-small-latest)

    mistral/mistral-small-latest は Mistral Small 4 に対応し、Chat Completions API で reasoning_effort を通じて 調整可能な推論 をサポートします (none は出力内の追加思考を最小化し、high は最終回答の前に完全な思考トレースを表示します)。

    OpenClaw はセッションの thinking レベルを Mistral の API にマッピングします:

    OpenClaw thinking レベル Mistral reasoning_effort
    off / minimal none
    low / medium / high / xhigh / adaptive / max high
    メモリ埋め込み

    Mistral は /v1/embeddings を通じてメモリ埋め込みを提供できます (デフォルトモデル: mistral-embed)。

    {
      memorySearch: { provider: "mistral" },
    }
    
    認証とベース URL
    • Mistral 認証は MISTRAL_API_KEY (Bearer ヘッダー) を使用します。
    • プロバイダーのベース URL はデフォルトで https://api.mistral.ai/v1 になり、標準の OpenAI 互換チャット補完リクエスト形状を受け入れます。
    • オンボーディングのデフォルトモデルは mistral/mistral-large-latest です。
    • Mistral が必要なリージョン別エンドポイントを明示的に公開している場合にのみ、models.providers.mistral.baseUrl でベース URL を上書きしてください。

    関連