Mistral

隨附的 mistral 外掛會註冊四項合約：聊天補全、媒體理解（Voxtral 批次轉錄）、用於 Voice Call 的即時 STT（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

​

開始使用

1. 取得你的 API 金鑰

   在 Mistral Console 建立 API 金鑰。

2. 執行引導設定

   openclaw onboard --auth-choice mistral-api-key
   

   或直接傳入金鑰：

   openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
   
3. 設定預設模型

   {
     env: { MISTRAL_API_KEY: "sk-..." },
     agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
   }
   
4. 確認模型可用

   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 --plain

在不啟動閘道的情況下對模型進行冒煙測試：

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "請只回覆：mistral-ok" \
  --json

​

音訊轉錄（Voxtral）

透過媒體理解流水線使用 Voxtral 進行批次音訊轉錄：

{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}

媒體轉錄路徑使用 /v1/audio/transcriptions。Mistral 的預設音訊模型是 voxtral-mini-latest。

​

Voice Call 串流 STT

隨附的 mistral 外掛會將 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,
              },
            },
          },
        },
      },
    },
  },
}

OpenClaw 預設將 Mistral 即時 STT 設為 pcm_mulaw、8 kHz，讓 Voice Call 能直接轉送 Twilio 媒體影格。只有在上游串流已經是原始 PCM 時，才使用 encoding: "pcm_s16le" 及相符的 sampleRate。

​

進階設定

可調整推理

mistral/mistral-small-latest、mistral/mistral-small-2603 和 mistral/mistral-medium-3-5 可透過 reasoning_effort 在 Chat Completions API 上支援可調整推理（none 會將輸出中的額外思考降至最低；high 會在最終答案前顯示完整的思考軌跡）。

OpenClaw 會將工作階段的 思考 層級對應至 Mistral API：

OpenClaw 思考層級	Mistral reasoning_effort
關閉 / 最低	none
低 / 中 / 高 / 超高 / 自適應 / 最高	high

避免將 Medium 3.5 推理模式與 temperature: 0 搭配使用；據報 Mistral HTTP API 會以 400 回應拒絕 reasoning_effort="high" 加上 temperature: 0。請不要設定溫度，或將思考設為關閉／最低，讓 OpenClaw 在你設定低溫度之前先傳送 reasoning_effort: "none"。

Medium 3.5 推理的模型範圍設定範例：

{
  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）：

{
  memory: {
    search: { 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。

​

相關內容

模型選擇

選擇提供者、模型參照及容錯移轉行為。

媒體理解

音訊轉錄設定與提供者選擇。