Mistral

バンドルされている mistral Plugin は、チャット補完、メディア理解（Voxtral バッチ文字起こし）、Voice Call 用リアルタイム STT（Voxtral Realtime）、メモリ埋め込み（mistral-embed）の 4 つのコントラクトを登録します。

プロパティ	値
プロバイダー ID	`mistral`
Plugin	バンドル済み、デフォルトで有効
認証環境変数	`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 カタログ

モデル参照	入力	コンテキスト	最大出力	注記
`mistral/mistral-large-latest`	テキスト、画像	262,144	16,384	デフォルトモデル
`mistral/mistral-medium-2508`	テキスト、画像	262,144	8,192	Mistral Medium 3.1
`mistral/mistral-medium-3-5`	テキスト、画像	262,144	8,192	Mistral Medium 3.5、調整可能な推論
`mistral/mistral-small-latest`	テキスト、画像	262,144	16,384	最新の Mistral Small 4、調整可能な `reasoning_effort`
`mistral/mistral-small-2603`	テキスト、画像	262,144	16,384	バージョン固定の Mistral Small 4、調整可能な `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	推論対応

設定を変更する前に、バンドルされているカタログ行を確認します。

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.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,
              },
            },
          },
        },
      },
    },
  },
}

OpenClaw は Mistral のリアルタイム STT をデフォルトで 8 kHz の pcm_mulaw に設定するため、Voice Call は Twilio メディアフレームを直接転送できます。アップストリームのストリームがすでに raw PCM である場合に限り、encoding: "pcm_s16le" と、それに一致する sampleRate を使用してください。

高度な設定

調整可能な推論

mistral/mistral-small-latest、mistral/mistral-small-2603、mistral/mistral-medium-3-5 は、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`

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）。

{
  memory: {
    search: { provider: "mistral" },
  },
}

認証とベース URL

Mistral の認証には MISTRAL_API_KEY（Bearer ヘッダー）を使用します。
プロバイダーのベース URL はデフォルトで https://api.mistral.ai/v1 となり、標準の OpenAI 互換 chat-completions リクエスト形式を受け付けます。
オンボーディングのデフォルトモデルは mistral/mistral-large-latest です。
Mistral が必要なリージョンエンドポイントを明示的に公開している場合に限り、models.providers.mistral.baseUrl でベース URL を上書きしてください。

モデルの選択

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

メディア理解

音声文字起こしの設定とプロバイダーの選択。

Overview

Concepts and configuration

Providers

はじめに

組み込み LLM カタログ

音声文字起こし（Voxtral）

Voice Call ストリーミング STT

高度な設定

関連項目

モデルの選択

メディア理解

​はじめに

​組み込み LLM カタログ

​音声文字起こし（Voxtral）

​Voice Call ストリーミング STT

​高度な設定

​関連項目

モデルの選択

メディア理解

はじめに

組み込み LLM カタログ

音声文字起こし（Voxtral）

Voice Call ストリーミング STT

高度な設定

関連項目