Skip to main content

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.

OpenClaw 支持 Mistral 用于文本/图像模型路由（mistral/...）以及 通过媒体理解中的 Voxtral 进行音频转录。 Mistral 也可用于记忆嵌入（memorySearch.provider = "mistral"）。
  • 提供方：mistral
  • 认证：MISTRAL_API_KEY
  • API：Mistral Chat Completions（https://api.mistral.ai/v1）

​
开始使用

1

获取你的 API 密钥

在 Mistral Console 中创建一个 API 密钥。
2

运行接入引导

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

设置默认模型

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

验证模型是否可用

openclaw models list --provider mistral

​
内置 LLM 目录

OpenClaw 当前附带以下 Mistral 目录：
模型引用输入上下文最大输出备注
mistral/mistral-large-latesttext, image262,14416,384默认模型
mistral/mistral-medium-2508text, image262,1448,192Mistral Medium 3.1
mistral/mistral-small-latesttext, image128,00016,384Mistral Small 4；可通过 API reasoning_effort 调整推理强度
mistral/pixtral-large-latesttext, image128,00032,768Pixtral
mistral/codestral-latesttext256,0004,096编码
mistral/devstral-medium-latesttext262,14432,768Devstral 2
mistral/magistral-smalltext128,00040,000支持推理

​
音频转录（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，并在 Chat Completions API 上通过 reasoning_effort 支持可调整推理（none 会尽量减少输出中的额外思考；high 会在最终答案前展示完整思考轨迹）。OpenClaw 会将会话的 thinking 级别映射到 Mistral 的 API：
OpenClaw thinking 级别Mistral reasoning_effort
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
其他内置的 Mistral 目录模型不使用此参数。当你想要 Mistral 原生的“优先推理”行为时，请继续使用 magistral-* 模型。
Mistral 可以通过 /v1/embeddings 提供记忆嵌入（默认模型：mistral-embed）。
{
  memorySearch: { provider: "mistral" },
}
  • Mistral 认证使用 MISTRAL_API_KEY。
  • 提供方基础 URL 默认是 https://api.mistral.ai/v1。
  • 接入引导的默认模型是 mistral/mistral-large-latest。
  • Z.AI 使用带有你的 API 密钥的 Bearer 认证。

​
相关内容

模型选择

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

媒体理解

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