跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 支援 Mistral，用於文字/圖片模型路由（mistral/...），也支援在媒體理解中透過 Voxtral 進行音訊轉錄。 Mistral 也可用於記憶嵌入（memorySearch.provider = "mistral"）。
  • 提供者：mistral
  • 驗證：MISTRAL_API_KEY
  • API：Mistral Chat Completions（https://api.mistral.ai/v1）

​
開始使用

1

Get your API key

在 Mistral Console 中建立 API 金鑰。
2

Run onboarding

openclaw onboard --auth-choice mistral-api-key
或直接傳入金鑰：
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

Set a default model

{
  env: { MISTRAL_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
}
4

Verify the model is available

openclaw models list --provider mistral

​
內建 LLM 目錄

OpenClaw 目前隨附以下 Mistral 目錄：
模型參照輸入上下文最大輸出備註
mistral/mistral-large-latest文字、圖片262,14416,384預設模型
mistral/mistral-medium-2508文字、圖片262,1448,192Mistral Medium 3.1
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已啟用推理

​
音訊轉錄（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 Plugin 會將 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 Small 4，並在 Chat Completions API 上透過 reasoning_effort 支援可調整推理（none 會將輸出中的額外思考降到最低；high 會在最終答案前顯示完整思考軌跡）。OpenClaw 會將工作階段的 thinking 等級對應到 Mistral 的 API：
OpenClaw thinking 等級Mistral reasoning_effort
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
其他隨附的 Mistral 目錄模型不使用此參數。當你想要 Mistral 原生以推理為先的行為時，請繼續使用 magistral-* 模型。
Mistral 可以透過 /v1/embeddings 提供記憶嵌入（預設模型：mistral-embed）。
{
  memorySearch: { provider: "mistral" },
}
  • Mistral 驗證使用 MISTRAL_API_KEY。
  • 提供者基底 URL 預設為 https://api.mistral.ai/v1。
  • 上線引導預設模型為 mistral/mistral-large-latest。
  • Z.AI 會使用你的 API 金鑰進行 Bearer 驗證。

​
相關

Model selection

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

Media understanding

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