Providers
Mistral
隨附的 mistral 外掛註冊了四項契約：聊天補全、媒體理解（Voxtral 批次轉錄）、用於語音通話的即時語音轉文字（Voxtral Realtime），以及記憶嵌入（mistral-embed）。
| 屬性 | 值 |
|---|---|
| 提供者 ID | mistral |
| 外掛 | 隨附，預設啟用 |
| 驗證環境變數 | MISTRAL_API_KEY |
| 初始設定旗標 | --auth-choice mistral-api-key |
| 直接命令列旗標 | --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內建大型語言模型目錄
| 模型參照 | 輸入 | 上下文 | 最大輸出 | 備註 |
|---|---|---|---|---|
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無須啟動閘道即可對模型進行快速測試：
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" }], }, }, },}語音通話串流語音轉文字
隨附的 mistral 外掛將 Voxtral Realtime 註冊為語音通話串流語音轉文字提供者。
| 設定 | 設定路徑 | 預設值 |
|---|---|---|
| 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 支援透過 reasoning_effort 在聊天補全 API 上使用可調整推理（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?
