Mistral

OpenClaw 包含一個內建的 Mistral 外掛，註冊了四種合約：聊天補全、媒體理解 (Voxtral 批次轉錄)、語音通話即時語音轉文字 (Voxtral Realtime)，以及記憶嵌入 (mistral-embed)。

屬性	值
提供者 ID	`mistral`
外掛	內建，`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" } } },
}

驗證模型可用
Terminal window
```
openclaw models list --provider mistral
```

內建 LLM 目錄

Mistral Medium 3.5 是目前內建目錄中的混合 Medium 模型：128B 密集權重、文字和圖片輸入、256K 上下文、函式呼叫、結構化輸出、編碼，以及透過聊天補全 API 進行可調整的推理。當您想要使用 Mistral 較新的統一代理/編碼模型，而不是預設的 mistral/mistral-large-latest 時，請使用 mistral/mistral-medium-3-5。

OpenClaw 目前提供此內建的 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`	文字、圖片	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	啟用推理

完成上線後，在不啟動 Gateway 的情況下對 Medium 3.5 進行冒煙測試：

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json

若要在變更設定前瀏覽內建的目錄列：

openclaw models list --all --provider mistral --plain

音訊轉錄 (Voxtral)

透過媒體理解管線使用 Voxtral 進行批次音訊轉錄。

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

語音通話串流 STT

內建的 mistral 外掛將 Voxtral Realtime 註冊為語音通話串流 STT 提供者。

設定	Config 路徑	預設值
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 Small 4) 和 mistral/mistral-medium-3-5 支援透過 reasoning_effort 在 Chat Completions API 上使用可調整推理 (none 最大限度減少輸出中的額外思考；high 在最終答案之前顯示完整的思考軌跡)。Mistral 建議將 reasoning_effort="high" 用於 Medium 3.5 智慧體和程式碼使用案例。

OpenClaw 將會話 thinking 等級對應到 Mistral 的 API：

OpenClaw thinking 等級	Mistral `reasoning_effort`
off / minimal	`none`
low / medium / high / xhigh / adaptive / max	`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)。

{
  memorySearch: { provider: "mistral" },
}

Auth and base URL

Mistral 驗證使用 MISTRAL_API_KEY (Bearer 標頭)。
提供者基礎 URL 預設為 https://api.mistral.ai/v1，並接受標準的 OpenAI 相容聊天完成請求格式。
上架預設模型為 mistral/mistral-large-latest。
僅當 Mistral 明確發佈您需要的區域端點時，才在 models.providers.mistral.baseUrl 下覆蓋基礎 URL。