> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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 ` | | 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` | ## はじめに [Mistral Console](https://console.mistral.ai/) で API キーを作成します。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice mistral-api-key ``` またはキーを直接渡します。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --mistral-api-key "$MISTRAL_API_KEY" ``` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { env: { MISTRAL_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } }, } ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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` | テキスト、画像 | 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 | 推論対応 | 設定を変更する前に、バンドル済みカタログの行を確認します。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --all --provider mistral --plain ``` Gateway を起動せずにモデルをスモークテストします。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer model run --local \ --model mistral/mistral-medium-3-5 \ --prompt "Reply with exactly: mistral-ok" \ --json ``` ## 音声文字起こし (Voxtral) メディア理解パイプラインを通じたバッチ音声文字起こしには Voxtral を使用します。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` | ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` による [調整可能な推論](https://docs.mistral.ai/studio-api/conversations/reasoning/adjustable) をサポートします (`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 推論向けのモデルスコープ設定例: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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`)。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 をオーバーライドしてください。 ## 関連 プロバイダー、モデル参照、フェイルオーバー動作の選択。 音声文字起こしのセットアップとプロバイダー選択。