Mistral

官方外部 mistral 插件注册了四项功能：聊天补全、媒体理解（Voxtral 批量转录）、用于 Voice Call 的实时 STT （Voxtral Realtime）以及记忆嵌入（mistral-embed）。

属性	值
提供商 ID	`mistral`
插件	`@openclaw/mistral-provider`
认证环境变量	`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`

开始使用

安装插件

openclaw plugins install @openclaw/mistral-provider
openclaw gateway restart

获取 API 密钥

在 Mistral 控制台中创建 API 密钥。

运行接入引导

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

或者直接传入密钥：

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

设置默认模型

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

验证模型是否可用

openclaw models list --provider mistral

内置 LLM 目录

模型引用	输入	上下文	最大输出	备注
`mistral/mistral-large-latest`	文本、图像	262,144	16,384	默认模型
`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/codestral-latest`	文本	128,000	4,096	编程
`mistral/mistral-medium-2508`	文本、图像	128,000	8,192	已弃用；隐藏；请使用 Mistral Medium 3.5
`mistral/devstral-medium-latest`	文本、图像	262,144	32,768	已弃用；隐藏；请使用 Mistral Medium 3.5

更改配置前，请查看插件目录中的对应行：

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

在不启动 Gateway 的情况下对模型进行烟雾测试：

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "只回复：mistral-ok" \
  --json

音频转录（Voxtral）

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

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

媒体转录路径使用 /v1/audio/transcriptions。Mistral 的默认音频模型是 voxtral-mini-latest。

语音通话流式 STT

mistral 插件将 Voxtral Realtime 注册为语音通话流式 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,
              },
            },
          },
        },
      },
    },
  },
}

OpenClaw 默认将 Mistral 实时 STT 设置为 8 kHz 的 pcm_mulaw，因此语音通话可以直接转发 Twilio 媒体帧。仅当你的上游流已经是原始 PCM 时，才使用 encoding: "pcm_s16le" 并匹配相应的 sampleRate。

高级配置

可调推理

mistral/mistral-small-latest、mistral/mistral-small-2603 和 mistral/mistral-medium-3-5 通过 reasoning_effort 支持 Chat Completions API 的可调推理（none 可最大限度减少输出中的额外思考；high 会在最终答案之前展示完整的思考过程）。OpenClaw 会将会话的 thinking 级别映射到 Mistral 的 API：

OpenClaw thinking level	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 未设置，或者先关闭 thinking / 设为 minimal，这样在设置较低 temperature 之前，OpenClaw 会发送 reasoning_effort: "none"。

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

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

其他 Mistral 目录模型不使用此参数。Mistral 原生的 Magistral 模型已弃用；对于当前的 API 模型，请在 Mistral Small 4 或 Mistral Medium 3.5 上使用可调推理。

记忆嵌入

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

{
  memory: {
    search: { provider: "mistral" },
  },
}

身份验证和基础 URL

Mistral 认证使用 MISTRAL_API_KEY（Bearer 头）。
提供方基础 URL 默认为 https://api.mistral.ai/v1，并接受标准的 OpenAI 兼容 chat-completions 请求格式。
接入引导的默认模型是 mistral/mistral-large-latest。
只有当 Mistral 明确发布了你需要的区域端点时，才在 models.providers.mistral.baseUrl 下覆盖基础 URL。

模型选择

选择提供方、模型引用和故障转移行为。

媒体理解

音频转录设置和提供方选择。

概览

概念与配置

提供商

开始使用

内置 LLM 目录

音频转录（Voxtral）

语音通话流式 STT

高级配置

相关内容

模型选择

媒体理解

​开始使用

​内置 LLM 目录

​音频转录（Voxtral）

​语音通话流式 STT

​高级配置

​相关内容

模型选择

媒体理解

开始使用

内置 LLM 目录

音频转录（Voxtral）

语音通话流式 STT

高级配置

相关内容