提供商

Mistral

内置的 mistral 插件注册了四项契约：聊天补全、媒体理解（Voxtral 批量转录）、用于语音通话的实时 STT（Voxtral Realtime），以及记忆嵌入（mistral-embed）。

属性	值
提供商 ID	`mistral`
插件	内置，默认启用
身份验证环境变量	`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 key

在 Mistral Console 中创建 API key。

运行新手引导

bash

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

或直接传入密钥：

bash

openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"

设置默认模型

json5

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

验证模型是否可用

bash

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	已启用推理

更改配置前，先浏览内置目录条目：

bash

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

无需启动 Gateway 网关即可对模型进行冒烟测试：

bash

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

音频转录（Voxtral）

通过媒体理解管线使用 Voxtral 进行批量音频转录：

json5

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

语音通话流式 STT

内置的 mistral 插件将 Voxtral Realtime 注册为语音通话流式 STT 提供商。

设置	配置路径	默认值
API key	`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`

json5

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

高级配置

可调节推理

mistral/mistral-small-latest、mistral/mistral-small-2603 和 mistral/mistral-medium-3-5 通过 reasoning_effort 在聊天补全 API 上支持可调节推理（none 可尽量减少输出中的额外思考；high 会在最终答案前呈现完整的思考轨迹）。

OpenClaw 将会话的思考级别映射到 Mistral API：

OpenClaw 思考级别	Mistral `reasoning_effort`
关闭 / 最少	`none`
低 / 中 / 高 / 极高 / 自适应 / 最大	`high`

Medium 3.5 推理的模型范围配置示例：

json5

{  agents: {    defaults: {      model: { primary: "mistral/mistral-medium-3-5" },      models: {        "mistral/mistral-medium-3-5": {          params: { thinking: "high" },        },      },    },  },}

记忆嵌入

Mistral 可以通过 /v1/embeddings 提供记忆嵌入（默认模型：mistral-embed）：

json5

{  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。

本页内容

Mistral

入门指南

获取 API key

运行新手引导

设置默认模型

验证模型是否可用

内置 LLM 目录

音频转录（Voxtral）

语音通话流式 STT

高级配置

相关内容

Molty