跳转到内容
OpenClaw Docs

Mistral

OpenClaw 包含一个捆绑的 Mistral 插件，该插件注册了四个合约：聊天补全、媒体理解（Voxtral 批量转录）、语音通话的实时 STT（Voxtral Realtime）和记忆嵌入（OpenClawmistral-embed）。

属性值
提供商 IDmistral
插件捆绑，enabledByDefault: true
认证环境变量MISTRAL_API_KEY
新手引导标志--auth-choice mistral-api-key
直接 CLI 标志--mistral-api-key <key>
APIOpenAI-兼容 (openai-completions)
基础 URLhttps://api.mistral.ai/v1
默认模型mistral/mistral-large-latest
嵌入模型mistral-embed
Voxtral 批处理voxtral-mini-latest (音频转录)
Voxtral 实时voxtral-mini-transcribe-realtime-2602

入门指南

Section titled “入门指南”

  1. 获取您的 API 密钥

    在 Mistral Console 中创建 API 密钥。

  2. 运行新手引导

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

    或者直接传入密钥：

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

  3. 设置默认模型

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

  4. 验证模型可用性

    Terminal window
    openclaw models list --provider mistral

内置 LLM 目录

Section titled “内置 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 进行冒烟测试：

Terminal window
openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json

要在更改配置之前浏览捆绑的目录行：

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

音频转录

Section titled “音频转录”

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

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

语音通话流式 STT

Section titled “语音通话流式 STT”

内置的 mistral 插件将 Voxtral Realtime 注册为语音通话流式 STT 提供商。

设置配置路径默认值
API 密钥plugins.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,
              },
            },
          },
        },
      },
    },
  },
}

高级配置

Section titled “高级配置”
可调整推理

mistral/mistral-small-latest (Mistral Small 4) 和 mistral/mistral-medium-3-5 支持通过聊天补全 API (API) 进行可调整推理，参数为 reasoning_effort (none 最小化输出中的额外思考；high 在最终答案前显示完整的思考轨迹)。对于 Medium 3.5 代理和代码用例，Mistral 推荐 reasoning_effort="high"。

OpenClaw 将会话 thinking 级别映射到 Mistral 的 API (API)：

OpenClaw thinking 级别Mistral reasoning_effort
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh

用于 Medium 3.5 推理的模型范围配置示例：

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

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

{
  memorySearch: { provider: "mistral" },
}
Auth and base URL
  • Mistral auth uses MISTRAL_API_KEY (Bearer header).
  • Provider base URL defaults to https://api.mistral.ai/v1 and accepts the standard OpenAI-compatible chat-completions request shape.
  • 新手引导 default 模型 is mistral/mistral-large-latest.
  • Override the base URL under models.providers.mistral.baseUrl only when Mistral explicitly publishes a regional endpoint you need.
Section titled “Related”
模型选择

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

媒体理解

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