--- read_when: - 你想在 OpenClaw 中使用 Mistral 模型 - 你想要用于语音通话的 Voxtral 实时转录 - 你需要 Mistral API 密钥新手引导和模型引用 summary: 在 OpenClaw 中使用 Mistral 模型和 Voxtral 转录 title: Mistral x-i18n: generated_at: "2026-05-10T19:46:40Z" model: gpt-5.5 provider: openai source_hash: 94c4caa86d4a3eb873d8b6a1cc639edbad3dd7478f401e2ca53f704de095f829 source_path: providers/mistral.md workflow: 16 --- OpenClaw 包含一个内置的 Mistral 插件，它注册了四个契约：聊天补全、媒体理解（Voxtral 批量转录）、用于 Voice Call 的实时 STT（Voxtral Realtime）和记忆嵌入（`mistral-embed`）。 | 属性 | 值 | | ---------------- | ------------------------------------------- | | 提供商 ID | `mistral` | | 插件 | 内置，`enabledByDefault: true` | | 凭证环境变量 | `MISTRAL_API_KEY` | | 新手引导标志 | `--auth-choice mistral-api-key` | | 直接 CLI 标志 | `--mistral-api-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` | ## 入门指南 在 [Mistral Console](https://console.mistral.ai/) 中创建一个 API key。 ```bash openclaw onboard --auth-choice mistral-api-key ``` 或者直接传入 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 Medium 3.5](https://docs.mistral.ai/models/model-cards/mistral-medium-3-5-26-04) 是内置目录中当前的混合 Medium 模型：128B 稠密权重、 文本和图像输入、256K 上下文、函数调用、结构化输出、编码， 并通过 Chat Completions 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 进行冒烟测试： ```bash openclaw infer model run --local \ --model mistral/mistral-medium-3-5 \ --prompt "Reply with exactly: mistral-ok" \ --json ``` 要在更改配置前浏览内置目录行： ```bash openclaw models list --all --provider mistral --plain ``` ## 音频转录（Voxtral） 通过媒体理解管线使用 Voxtral 进行批量音频转录。 ```json5 { 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 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, }, }, }, }, }, }, }, } ``` OpenClaw 将 Mistral 实时 STT 默认设置为 8 kHz 的 `pcm_mulaw`，这样 Voice Call 可以直接转发 Twilio 媒体帧。仅当你的上游流已经是原始 PCM 时，才使用 `encoding: "pcm_s16le"` 和匹配的 `sampleRate`。 ## 高级配置 `mistral/mistral-small-latest`（Mistral Small 4）和 `mistral/mistral-medium-3-5` 支持通过 Chat Completions API 上的 `reasoning_effort`（`none` 会最大限度减少输出中的额外思考；`high` 会在最终答案前显示完整思考轨迹）进行[可调推理](https://docs.mistral.ai/studio-api/conversations/reasoning/adjustable)。Mistral 建议在 Medium 3.5 的智能体式和代码使用场景中使用 `reasoning_effort="high"`。 OpenClaw 将会话 **thinking** 级别映射到 Mistral 的 API： | OpenClaw thinking 级别 | Mistral `reasoning_effort` | | ------------------------------------------------ | -------------------------- | | **off** / **minimal** | `none` | | **low** / **medium** / **high** / **xhigh** / **adaptive** / **max** | `high` | 不要将 Medium 3.5 推理模式与 `temperature: 0` 组合使用。Mistral HTTP API 会拒绝 `reasoning_effort="high"` 加 `temperature: 0`，并返回 400 响应。请保持 temperature 未设置，让 Mistral 使用其默认值，或遵循 [Medium 3.5 推荐设置](https://huggingface.co/mistralai/Mistral-Medium-3.5-128B)， 在高推理时使用 `temperature: 0.7`。对于确定性的直接 答案，请关闭 thinking 或将其设为 minimal，这样 OpenClaw 会先发送 `reasoning_effort: "none"`，然后你再降低 temperature。 Medium 3.5 推理的模型作用域配置示例： ```json5 { 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`）。 ```json5 { memorySearch: { provider: "mistral" }, } ``` - Mistral 凭证使用 `MISTRAL_API_KEY`（Bearer header）。 - 提供商基础 URL 默认为 `https://api.mistral.ai/v1`，并接受标准的兼容 OpenAI 聊天补全请求形状。 - 新手引导默认模型是 `mistral/mistral-large-latest`。 - 仅当 Mistral 明确发布你需要的区域端点时，才在 `models.providers.mistral.baseUrl` 下覆盖基础 URL。 ## 相关 选择提供商、模型引用和故障转移行为。 音频转录设置和提供商选择。