Providers
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 --plainGateway を起動せずにモデルをスモークテストします。
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" }], }, }, },}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, }, }, }, }, }, }, },}高度な設定
調整可能な推論
mistral/mistral-small-latest、mistral/mistral-small-2603、および mistral/mistral-medium-3-5 は、Chat Completions API で reasoning_effort を介した調整可能な推論をサポートします（none は出力内の追加思考を最小化し、high は最終回答の前に完全な思考の軌跡を表示します）。
OpenClaw はセッションの思考レベルを Mistral の API に次のようにマッピングします。
| OpenClaw の思考レベル | Mistral の reasoning_effort |
|---|---|
| オフ / 最小 | none |
| 低 / 中 / 高 / 非常に高い / 適応型 / 最大 | high |
Medium 3.5 の推論に対するモデルスコープ設定の例：
{ agents: { defaults: { model: { primary: "mistral/mistral-medium-3-5" }, models: { "mistral/mistral-medium-3-5": { params: { thinking: "high" }, }, }, }, },}メモリ埋め込み
Mistral は /v1/embeddings を介してメモリ埋め込みを提供できます（デフォルトモデル：mistral-embed）。
{ agents: { defaults: { 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 を上書きしてください。
関連項目
Was this useful?
