Providers
Mistral
OpenClaw 包含一個內建的 Mistral Plugin，會註冊四個合約：聊天補全、媒體理解（Voxtral 批次轉錄）、Voice Call 的即時 STT（Voxtral Realtime），以及記憶嵌入（mistral-embed）。
| 屬性 | 值 |
|---|---|
| 供應商 ID | mistral |
| Plugin | 內建，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" } } },
}
確認模型可用
openclaw models list --provider mistral
內建 LLM 目錄
OpenClaw 目前隨附此內建 Mistral 目錄：
| 模型參照 | 輸入 | 上下文 | 最大輸出 | 備註 |
|---|---|---|---|---|
mistral/mistral-large-latest |
文字、影像 | 262,144 | 16,384 | 預設模型 |
mistral/mistral-medium-2508 |
文字、影像 | 262,144 | 8,192 | Mistral Medium 3.1 |
mistral/mistral-small-latest |
文字、影像 | 128,000 | 16,384 | Mistral Small 4；可透過 API reasoning_effort 調整理 reasoning |
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 | 已啟用 reasoning |
音訊轉錄（Voxtral）
透過媒體理解管線使用 Voxtral 進行批次音訊轉錄。
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "mistral", model: "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.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,
},
},
},
},
},
},
},
}
進階設定
可調整的 reasoning（mistral-small-latest）
mistral/mistral-small-latest 對應到 Mistral Small 4，並支援在 Chat Completions API 上透過 reasoning_effort 使用可調整的 reasoning（none 會將輸出中的額外思考降到最低；high 會在最終答案前顯示完整思考軌跡）。
OpenClaw 會將工作階段的 thinking 層級對應到 Mistral 的 API：
| OpenClaw thinking 層級 | Mistral reasoning_effort |
|---|---|
| off / minimal | none |
| low / medium / high / xhigh / adaptive / max | high |
記憶嵌入
Mistral 可以透過 /v1/embeddings 提供記憶嵌入（預設模型：mistral-embed）。
{
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。