跳轉到主要內容
內建的 mistral 外掛註冊四種合約：聊天補全、媒體理解（Voxtral 批次轉錄）、Voice Call 的即時 STT（Voxtral Realtime），以及記憶嵌入（mistral-embed）。
屬性值
提供者 IDmistral
外掛內建，預設啟用
驗證環境變數MISTRAL_API_KEY
入門設定旗標--auth-choice mistral-api-key
直接命令列旗標--mistral-api-key <key>
APIOpenAI 相容（openai-completions）
基底 URLhttps://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,14416,384預設模型
mistral/mistral-medium-2508文字、影像262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5文字、影像262,1448,192Mistral Medium 3.5；可調推理
mistral/mistral-small-latest文字、影像128,00016,384Mistral Small 4；透過 API reasoning_effort 可調推理
mistral/pixtral-large-latest文字、影像128,00032,768Pixtral
mistral/codestral-latest文字256,0004,096程式碼
mistral/devstral-medium-latest文字262,14432,768Devstral 2
mistral/magistral-small文字128,00040,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" }],
      },
    },
  },
}
媒體轉錄路徑使用 /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.modelvoxtral-mini-transcribe-realtime-2602
編碼...mistral.encodingpcm_mulaw
取樣率...mistral.sampleRate8000
目標延遲...mistral.targetStreamingDelayMs800
{
  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 使用可調推理（none 會讓輸出中的額外思考最少；high 會在最終答案前顯示完整思考軌跡）。OpenClaw 會將工作階段的 thinking 層級對應到 Mistral 的 API：
OpenClaw thinking 層級Mistral reasoning_effort
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
避免將 Medium 3.5 推理模式與 temperature: 0 搭配使用；據回報，Mistral HTTP API 會拒絕 reasoning_effort="high" 加上 temperature: 0，並回傳 400 回應。請不要設定 temperature，或將 thinking 關閉/設為 minimal，讓 OpenClaw 在你設定低 temperature 前先傳送 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）：
{
  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。

​
相關

模型選擇

選擇提供者、模型參照與故障轉移行為。

媒體理解

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