メインコンテンツへスキップ
バンドル済みの mistral Plugin は、チャット補完、メディア理解 (Voxtral バッチ文字起こし)、Voice Call 用リアルタイム STT (Voxtral Realtime)、メモリ埋め込み (mistral-embed) の4つのコントラクトを登録します。
プロパティ値
プロバイダー IDmistral
Pluginバンドル済み、デフォルトで有効
認証環境変数MISTRAL_API_KEY
オンボーディングフラグ--auth-choice mistral-api-key
直接 CLI フラグ--mistral-api-key <key>
APIOpenAI 互換 (openai-completions)
ベース URLhttps://api.mistral.ai/v1
デフォルトモデルmistral/mistral-large-latest
埋め込みモデルmistral-embed
Voxtral バッチvoxtral-mini-latest (音声文字起こし)
Voxtral リアルタイムvoxtral-mini-transcribe-realtime-2602

​
はじめに

1

API キーを取得する

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

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

openclaw onboard --auth-choice mistral-api-key
またはキーを直接渡します。
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

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

{
  env: { MISTRAL_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
}
4

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

openclaw models list --provider mistral

​
組み込み LLM カタログ

モデル参照入力コンテキスト最大出力メモ
mistral/mistral-large-latestテキスト、画像262,14416,384デフォルトモデル
mistral/mistral-medium-2508テキスト、画像262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5テキスト、画像262,1448,192Mistral Medium 3.5。調整可能な推論
mistral/mistral-small-latestテキスト、画像128,00016,384Mistral Small 4。API reasoning_effort による調整可能な推論
mistral/pixtral-large-latestテキスト、画像128,00032,768Pixtral
mistral/codestral-latestテキスト256,0004,096コーディング
mistral/devstral-medium-latestテキスト262,14432,768Devstral 2
mistral/magistral-smallテキスト128,00040,000推論対応
設定を変更する前に、バンドル済みカタログの行を確認します。 
openclaw models list --all --provider mistral --plain
Gateway を起動せずにモデルをスモークテストします。 
openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json

​
音声文字起こし (Voxtral)

メディア理解パイプラインを通じたバッチ音声文字起こしには Voxtral を使用します。 
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}
メディア文字起こしパスは /v1/audio/transcriptions を使用します。Mistral のデフォルト音声モデルは voxtral-mini-latest です。

​
Voice Call ストリーミング STT

バンドル済みの mistral Plugin は、Voxtral Realtime を Voice Call ストリーミング STT プロバイダーとして登録します。
設定設定パスデフォルト
API キーplugins.entries.voice-call.config.streaming.providers.mistral.apiKeyMISTRAL_API_KEY にフォールバック
モデル...mistral.modelvoxtral-mini-transcribe-realtime-2602
エンコーディング...mistral.encodingpcm_mulaw
サンプルレート...mistral.sampleRate8000
目標遅延...mistral.targetStreamingDelayMs800
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
OpenClaw は Mistral のリアルタイム STT を 8 kHz の pcm_mulaw にデフォルト設定しているため、Voice Call は Twilio メディアフレームを直接転送できます。上流ストリームがすでに生 PCM の場合にのみ、encoding: "pcm_s16le" と一致する sampleRate を使用してください。

​
高度な設定

mistral/mistral-small-latest と mistral/mistral-medium-3-5 は、Chat Completions API で reasoning_effort による 調整可能な推論 をサポートします (none は出力内の追加思考を最小化し、high は最終回答の前に完全な思考トレースを表示します)。OpenClaw はセッションの thinking レベルを Mistral の API にマッピングします。
OpenClaw thinking レベルMistral reasoning_effort
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
Medium 3.5 の推論モードを temperature: 0 と組み合わせることは避けてください。Mistral HTTP API は、reasoning_effort="high" と temperature: 0 の組み合わせを 400 レスポンスで拒否することが報告されています。低い temperature を設定する前に、temperature を未設定のままにするか、thinking を off/minimal にして OpenClaw が reasoning_effort: "none" を送信するようにしてください。
Medium 3.5 推論向けのモデルスコープ設定例:
{
  agents: {
    defaults: {
      model: { primary: "mistral/mistral-medium-3-5" },
      models: {
        "mistral/mistral-medium-3-5": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
他のバンドル済み Mistral カタログモデルはこのパラメーターを使用しません。Mistral のネイティブな推論優先の動作が必要な場合は、引き続き magistral-* モデルを使用してください。
Mistral は /v1/embeddings 経由でメモリ埋め込みを提供できます (デフォルトモデル: mistral-embed)。
{
  agents: {
    defaults: {
      memorySearch: { provider: "mistral" },
    },
  },
}
  • Mistral 認証は MISTRAL_API_KEY (Bearer ヘッダー) を使用します。
  • プロバイダーのベース URL はデフォルトで https://api.mistral.ai/v1 で、標準の OpenAI 互換チャット補完リクエスト形状を受け付けます。
  • オンボーディングのデフォルトモデルは mistral/mistral-large-latest です。
  • Mistral が必要なリージョナルエンドポイントを明示的に公開している場合にのみ、models.providers.mistral.baseUrl 配下でベース URL をオーバーライドしてください。

​
関連

モデル選択

プロバイダー、モデル参照、フェイルオーバー動作の選択。

メディア理解

音声文字起こしのセットアップとプロバイダー選択。