Mistral

官方外部插件 mistral 注册了四个契约：聊天补全、媒体理解（Voxtral 批量转录）、用于语音通话的实时 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`

开始使用¶

1. 安装插件

openclaw plugins install @openclaw/mistral-provider

安装会自动应用于正在运行的 Gateway；否则将在下次启动时生效。参见应用更改并检查。

2. 获取您的 API 密钥

在 Mistral Console 中创建 API 密钥。

3. 运行 onboarding 引导

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

或直接传入密钥：

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

4. 设置默认模型

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

5. 验证模型是否可用

openclaw models list --provider mistral

内置 LLM 目录¶

模型引用	输入	上下文	最大输出	备注
`mistral/mistral-large-latest`	text, image	262,144	16,384	默认模型
`mistral/mistral-medium-3-5`	text, image	262,144	8,192	Mistral Medium 3.5；可调节推理
`mistral/mistral-small-latest`	text, image	262,144	16,384	Mistral Small 4 最新版；可调节 `reasoning_effort`
`mistral/mistral-small-2603`	text, image	262,144	16,384	Mistral Small 4 固定版；可调节 `reasoning_effort`
`mistral/codestral-latest`	text	128,000	4,096	编码
`mistral/mistral-medium-2508`	text, image	128,000	8,192	已弃用；已隐藏；请使用 Mistral Medium 3.5
`mistral/devstral-medium-latest`	text	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 "Reply with exactly: mistral-ok" \
  --json

音频转录（Voxtral）¶

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

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

Tip

媒体转录路径使用 /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,
              },
            },
          },
        },
      },
    },
  },
}

Note

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 上的[可调节推理](https://docs.mistral.ai/studio-api/conversations/reasoning)（`none` 最小化输出中的额外思考；`high` 在最终答案之前呈现完整思考痕迹）。

思考默认**关闭**。OpenClaw 接受以下会话思考级别，并将其映射到 Mistral 的 API：

OpenClaw 思考级别	Mistral `reasoning_effort`
off / minimal	`none`
low / medium / high / xhigh / adaptive / max	`high`

!!! warning

    避免将 Medium 3.5 推理模式与 `temperature: 0` 组合使用。有报告称 Mistral HTTP API 会拒绝 `reasoning_effort="high"` 与 `temperature: 0` 的组合，并返回 400 响应。请保持 temperature 未设置，或将思考设为 off/minimal，以便 OpenClaw 在你设置较低 temperature 之前发送 `reasoning_effort: "none"`。

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

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

!!! note

    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。

模型选择

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

媒体理解

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

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw