> ## Documentation Index > Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt > Use this file to discover all available pages before exploring further. # 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 ` | | 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` | ## 开始使用 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install @openclaw/mistral-provider openclaw gateway restart ``` 在 [Mistral 控制台](https://console.mistral.ai/) 中创建 API 密钥。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice mistral-api-key ``` 或者直接传入密钥： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --mistral-api-key "$MISTRAL_API_KEY" ``` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { env: { vars: { MISTRAL_API_KEY: "sk-..." } }, agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } }, } ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 | 更改配置前，请查看插件目录中的对应行： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --all --provider mistral --plain ``` 在不启动 Gateway 的情况下对模型进行烟雾测试： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer model run --local \ --model mistral/mistral-medium-3-5 \ --prompt "只回复：mistral-ok" \ --json ``` ## 音频转录（Voxtral） 通过媒体理解管道使用 Voxtral 进行批量音频转录： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` | ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 的[可调推理](https://docs.mistral.ai/studio-api/conversations/reasoning)（`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 推理的按模型配置示例： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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`）： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { memory: { search: { provider: "mistral" }, }, } ``` * Mistral 认证使用 `MISTRAL_API_KEY`（Bearer 头）。 * 提供方基础 URL 默认为 `https://api.mistral.ai/v1`，并接受标准的 OpenAI 兼容 chat-completions 请求格式。 * 接入引导的默认模型是 `mistral/mistral-large-latest`。 * 只有当 Mistral 明确发布了你需要的区域端点时，才在 `models.providers.mistral.baseUrl` 下覆盖基础 URL。 ## 相关内容 选择提供方、模型引用和故障转移行为。 音频转录设置和提供方选择。