本页内容

本页内容

供应商

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 <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
    openclaw plugins install @openclaw/mistral-provider

    安装自动应用于正在运行的网关;否则下次启动时生效。请参阅 应用更改并检查 。

  • 获取您的 API 密钥

    在 Mistral Console 中创建 API 密钥。

  • 运行入门引导培训

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

    或直接传入密钥:

    bash
    openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
  • 设置默认模型

    json5
    {  env: { vars: { MISTRAL_API_KEY: "sk-..." } },  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },}
  • 验证模型是否可用

    bash
    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
    openclaw models list --all --provider mistral --plain

    在不启动 Gateway 的情况下对模型进行烟雾测试:

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

    音频转录(Voxtral)

    通过媒体理解管道使用 Voxtral 进行批量音频转录:

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

    语音通话流 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
    {  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

    高级配置

    可调节推理

    mistral/mistral-small-latest、mistral/mistral-small-2603 和 mistral/mistral-medium-3-5 通过 reasoning_effort 支持 Chat Completions API 的可调推理(none 可最大限度减少输出中的额外思考;high 会在最终答案之前展示完整的思考过程)。

    思维默认为off。 OpenClaw 接受这些会话思维级别并将它们映射到 Mistral 的 API:

    OpenClaw思维水平 Mistral reasoning_effort
    off / 最小 none
    低 / 中 / 高 / x高 / 自适应 / max high

    Medium 3.5 推理的按模型配置示例:

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

    Mistral 可以通过 /v1/embeddings 提供记忆嵌入(默认模型:mistral-embed):

    json5
    {  memory: {    search: { provider: "mistral" },  },}
    授权和基础 URL
    • Mistral 认证使用 MISTRAL_API_KEY(Bearer 头)。
    • Provider 基础 URL 默认为 https://api.mistral.ai/v1 并接受标准 OpenAI- 兼容聊天完成请求形状。
    • 接入引导的默认模型是 mistral/mistral-large-latest。
    • 只有当 Mistral 明确发布了你需要的区域端点时,才在 models.providers.mistral.baseUrl 下覆盖基础 URL。

    相关内容

    本页有帮助吗?