Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 包含一个内置的 Mistral 插件，它注册了四个契约：聊天补全、媒体理解（Voxtral 批量转录）、用于 Voice Call 的实时 STT（Voxtral Realtime）和记忆嵌入（mistral-embed）。
属性值
提供商 IDmistral
插件内置，enabledByDefault: true
凭证环境变量MISTRAL_API_KEY
新手引导标志--auth-choice mistral-api-key
直接 CLI 标志--mistral-api-key <key>
API兼容 OpenAI（openai-completions）
基础 URLhttps://api.mistral.ai/v1
默认模型mistral/mistral-large-latest
嵌入模型mistral-embed
Voxtral 批量voxtral-mini-latest（音频转录）
Voxtral 实时voxtral-mini-transcribe-realtime-2602

​
入门指南

1

Get your API key

在 Mistral Console 中创建一个 API key。
2

Run onboarding

openclaw onboard --auth-choice mistral-api-key
或者直接传入 key：
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

Set a default model

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

Verify the model is available

openclaw models list --provider mistral

​
内置 LLM 目录

Mistral Medium 3.5 是内置目录中当前的混合 Medium 模型：128B 稠密权重、 文本和图像输入、256K 上下文、函数调用、结构化输出、编码， 并通过 Chat Completions API 支持可调推理。当你想使用 Mistral 更新的统一 智能体式/编码模型，而不是默认的 mistral/mistral-large-latest 时，请使用 mistral/mistral-medium-3-5。 OpenClaw 当前随附此内置 Mistral 目录：
模型引用输入上下文最大输出说明
mistral/mistral-large-latest文本，图像262,14416,384默认模型
mistral/mistral-medium-2508文本，图像262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5文本，图像262,1448,192Mistral Medium 3.5；可调推理
mistral/mistral-small-latest文本，图像128,00016,384Mistral Small 4；通过 API reasoning_effort 可调推理
mistral/pixtral-large-latest文本，图像128,00032,768Pixtral
mistral/codestral-latest文本256,0004,096编码
mistral/devstral-medium-latest文本262,14432,768Devstral 2
mistral/magistral-small文本128,00040,000已启用推理
完成新手引导后，无需启动 Gateway 网关 即可对 Medium 3.5 进行冒烟测试： 
openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json
要在更改配置前浏览内置目录行： 
openclaw models list --all --provider mistral --plain

​
音频转录（Voxtral）

通过媒体理解管线使用 Voxtral 进行批量音频转录。 
{
  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 keyplugins.entries.voice-call.config.streaming.providers.mistral.apiKey回退到 MISTRAL_API_KEY
模型...mistral.modelvoxtral-mini-transcribe-realtime-2602
编码...mistral.encodingpcm_mulaw
采样率...mistral.sampleRate8000
目标延迟...mistral.targetStreamingDelayMs800
{
  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 会在最终答案前显示完整思考轨迹）进行可调推理。Mistral 建议在 Medium 3.5 的智能体式和代码使用场景中使用 reasoning_effort="high"。OpenClaw 将会话 thinking 级别映射到 Mistral 的 API：
OpenClaw thinking 级别Mistral reasoning_effort
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
不要将 Medium 3.5 推理模式与 temperature: 0 组合使用。Mistral HTTP API 会拒绝 reasoning_effort="high" 加 temperature: 0，并返回 400 响应。请保持 temperature 未设置，让 Mistral 使用其默认值，或遵循 Medium 3.5 推荐设置， 在高推理时使用 temperature: 0.7。对于确定性的直接 答案，请关闭 thinking 或将其设为 minimal，这样 OpenClaw 会先发送 reasoning_effort: "none"，然后你再降低 temperature。
Medium 3.5 推理的模型作用域配置示例：
{
  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）。
{
  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。

​
相关

Model selection

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

Media understanding

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