--- read_when: - OpenClawでMistralモデルを使用したい場合 - 音声通話で Voxtral のリアルタイム文字起こしを使いたい場合 - Mistral API キーのオンボーディングとモデル参照が必要です summary: OpenClaw で Mistral モデルと Voxtral 文字起こしを使用する title: Mistral x-i18n: generated_at: "2026-05-10T19:50:04Z" model: gpt-5.5 provider: openai source_hash: 94c4caa86d4a3eb873d8b6a1cc639edbad3dd7478f401e2ca53f704de095f829 source_path: providers/mistral.md workflow: 16 --- OpenClaw には、chat completions、メディア理解（Voxtral バッチ文字起こし）、Voice Call 向け realtime STT（Voxtral Realtime）、memory embeddings（`mistral-embed`）の 4 つの契約を登録する同梱 Mistral Plugin が含まれています。 | プロパティ | 値 | | ---------------- | ------------------------------------------- | | Provider id | `mistral` | | Plugin | 同梱、`enabledByDefault: true` | | 認証 env var | `MISTRAL_API_KEY` | | Onboarding flag | `--auth-choice mistral-api-key` | | 直接 CLI flag | `--mistral-api-key ` | | API | OpenAI 互換（`openai-completions`） | | Base URL | `https://api.mistral.ai/v1` | | 既定モデル | `mistral/mistral-large-latest` | | 埋め込みモデル | `mistral-embed` | | Voxtral batch | `voxtral-mini-latest`（音声文字起こし） | | Voxtral realtime | `voxtral-mini-transcribe-realtime-2602` | ## はじめに [Mistral Console](https://console.mistral.ai/) で API キーを作成します。 ```bash openclaw onboard --auth-choice mistral-api-key ``` または、キーを直接渡します。 ```bash openclaw onboard --mistral-api-key "$MISTRAL_API_KEY" ``` ```json5 { env: { MISTRAL_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } }, } ``` ```bash openclaw models list --provider mistral ``` ## 組み込み LLM カタログ [Mistral Medium 3.5](https://docs.mistral.ai/models/model-cards/mistral-medium-3-5-26-04) は、同梱カタログ内の現在の blended Medium モデルです。128B の dense weights、 テキストと画像の入力、256K コンテキスト、関数呼び出し、構造化出力、コーディング、 Chat Completions API を通じた調整可能な推論に対応しています。既定の `mistral/mistral-large-latest` ではなく、Mistral の新しい統合 agentic/coding モデルを使いたい場合は `mistral/mistral-medium-3-5` を使用します。 OpenClaw は現在、この同梱 Mistral カタログを出荷しています。 | モデル ref | 入力 | コンテキスト | 最大出力 | 注記 | | -------------------------------- | ----------- | ------- | ---------- | ---------------------------------------------------------------- | | `mistral/mistral-large-latest` | text, image | 262,144 | 16,384 | 既定モデル | | `mistral/mistral-medium-2508` | text, image | 262,144 | 8,192 | Mistral Medium 3.1 | | `mistral/mistral-medium-3-5` | text, image | 262,144 | 8,192 | Mistral Medium 3.5、調整可能な推論 | | `mistral/mistral-small-latest` | text, image | 128,000 | 16,384 | Mistral Small 4、API `reasoning_effort` 経由の調整可能な推論 | | `mistral/pixtral-large-latest` | text, image | 128,000 | 32,768 | Pixtral | | `mistral/codestral-latest` | text | 256,000 | 4,096 | コーディング | | `mistral/devstral-medium-latest` | text | 262,144 | 32,768 | Devstral 2 | | `mistral/magistral-small` | text | 128,000 | 40,000 | 推論対応 | オンボーディング後、Gateway を起動せずに Medium 3.5 をスモークテストします。 ```bash openclaw infer model run --local \ --model mistral/mistral-medium-3-5 \ --prompt "Reply with exactly: mistral-ok" \ --json ``` 設定を変更する前に、同梱カタログの行を確認するには次を実行します。 ```bash openclaw models list --all --provider mistral --plain ``` ## 音声文字起こし（Voxtral） メディア理解パイプラインを通じたバッチ音声文字起こしには Voxtral を使用します。 ```json5 { 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 provider として登録します。 | 設定 | 設定パス | 既定値 | | ------------ | ---------------------------------------------------------------------- | --------------------------------------- | | 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` | ```json5 { plugins: { entries: { "voice-call": { config: { streaming: { enabled: true, provider: "mistral", providers: { mistral: { apiKey: "${MISTRAL_API_KEY}", targetStreamingDelayMs: 800, }, }, }, }, }, }, }, } ``` OpenClaw は Mistral realtime STT の既定を 8 kHz の `pcm_mulaw` にしているため、Voice Call は Twilio メディアフレームを直接転送できます。上流のストリームがすでに raw PCM の場合にのみ、 `encoding: "pcm_s16le"` と一致する `sampleRate` を使用してください。 ## 高度な設定 `mistral/mistral-small-latest`（Mistral Small 4）と `mistral/mistral-medium-3-5` は、Chat Completions API で `reasoning_effort` 経由の [調整可能な推論](https://docs.mistral.ai/studio-api/conversations/reasoning/adjustable) に対応しています（`none` は出力内の追加の思考を最小化します。`high` は最終回答の前に完全な思考トレースを表示します）。Mistral は、Medium 3.5 の agentic およびコードのユースケースに `reasoning_effort="high"` を推奨しています。 OpenClaw はセッションの **thinking** レベルを Mistral の API にマップします。 | OpenClaw thinking レベル | Mistral `reasoning_effort` | | ------------------------------------------------ | -------------------------- | | **off** / **minimal** | `none` | | **low** / **medium** / **high** / **xhigh** / **adaptive** / **max** | `high` | Medium 3.5 の reasoning mode と `temperature: 0` を組み合わせないでください。Mistral HTTP API は、`reasoning_effort="high"` と `temperature: 0` の組み合わせを 400 レスポンスで拒否します。Mistral が既定値を使用するよう temperature を未設定のままにするか、 [Medium 3.5 recommended settings](https://huggingface.co/mistralai/Mistral-Medium-3.5-128B) に従い、high reasoning には `temperature: 0.7` を使用してください。決定論的な直接回答では、 temperature を下げる前に thinking を off/minimal にして、OpenClaw が `reasoning_effort: "none"` を送信するようにします。 Medium 3.5 reasoning のモデルスコープ設定例: ```json5 { agents: { defaults: { model: { primary: "mistral/mistral-medium-3-5" }, models: { "mistral/mistral-medium-3-5": { params: { thinking: "high" }, }, }, }, }, } ``` その他の同梱 Mistral カタログモデルはこのパラメーターを使用しません。Mistral のネイティブな reasoning-first 挙動が必要な場合は、引き続き `magistral-*` モデルを使用してください。 Mistral は `/v1/embeddings` 経由で memory embeddings を提供できます（既定モデル: `mistral-embed`）。 ```json5 { memorySearch: { provider: "mistral" }, } ``` - Mistral 認証は `MISTRAL_API_KEY`（Bearer header）を使用します。 - Provider base URL の既定は `https://api.mistral.ai/v1` で、標準の OpenAI 互換 chat-completions request shape を受け付けます。 - オンボーディングの既定モデルは `mistral/mistral-large-latest` です。 - Mistral が必要な regional endpoint を明示的に公開している場合にのみ、`models.providers.mistral.baseUrl` で base URL を上書きしてください。 ## 関連 providers、model refs、failover behavior の選択。 音声文字起こしの設定と provider 選択。