Providers
Mistral
OpenClaw には、4 つのコントラクトを登録するバンドル済みの Mistral Plugin が含まれます: チャット補完、メディア理解 (Voxtral バッチ文字起こし)、音声通話向けリアルタイム STT (Voxtral Realtime)、メモリ埋め込み (mistral-embed) です。
| プロパティ | 値 |
|---|---|
| プロバイダー ID | mistral |
| Plugin | バンドル済み、enabledByDefault: true |
| 認証環境変数 | 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 カタログ
OpenClaw には現在、このバンドル済み Mistral カタログが含まれます:
| モデル参照 | 入力 | コンテキスト | 最大出力 | メモ |
|---|---|---|---|---|
mistral/mistral-large-latest |
テキスト、画像 | 262,144 | 16,384 | デフォルトモデル |
mistral/mistral-medium-2508 |
テキスト、画像 | 262,144 | 8,192 | Mistral Medium 3.1 |
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 | 推論対応 |
音声文字起こし (Voxtral)
メディア理解パイプラインを通じたバッチ音声文字起こしには Voxtral を使用します。
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
},
},
},
}
音声通話ストリーミング STT
バンドル済みの mistral Plugin は、Voxtral Realtime を音声通話ストリーミング 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-small-latest)
mistral/mistral-small-latest は Mistral Small 4 に対応し、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 |
メモリ埋め込み
Mistral は /v1/embeddings を通じてメモリ埋め込みを提供できます (デフォルトモデル: mistral-embed)。
{
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 を上書きしてください。