Mistral AI 模型配置教程

2025-07-10 · 4 分钟模型接入

概述

Mistral AI 是法国知名的 AI 研究公司，以高性价比的开源与商业模型著称。在 OpenClaw 中，Mistral 不仅支持标准文本推理，还覆盖了语音转录（Voxtral）和向量嵌入（Mistral Embed）两大能力，是功能最完整的接入提供商之一。提供者 ID 为 mistral，API 基础地址为 https://api.mistral.ai/v1。

快速开始

第一步：获取 API Key

前往 console.mistral.ai 注册并创建 API Key。

第二步：设置认证

export MISTRAL_API_KEY="your-mistral-api-key"

或使用 OpenClaw 引导命令：

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

配置参数

文本推理基础配置：

{
  env: {
    MISTRAL_API_KEY: "your-mistral-api-key"
  },
  agents: {
    defaults: {
      model: {
        primary: "mistral/mistral-large-latest"
      }
    }
  }
}

完整多功能配置（含语音转录）：

{
  env: {
    MISTRAL_API_KEY: "your-mistral-api-key"
  },
  agents: {
    defaults: {
      model: {
        primary: "mistral/mistral-large-latest"
      }
    }
  },
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [
          { provider: "mistral", model: "voxtral-mini-latest" }
        ]
      }
    }
  }
}

支持的模型

功能	模型 ID	说明
文本推理	`mistral/mistral-large-latest`	旗舰推理模型，能力最强
文本推理	`mistral/mistral-small-latest`	轻量快速版本
语音转录	`mistral/voxtral-mini-latest`	高效语音识别
向量嵌入	`mistral/mistral-embed`	语义搜索与记忆功能

向量嵌入配置

Mistral Embed 可用于 OpenClaw 的记忆系统，实现对话上下文的语义检索：

{
  memory: {
    embeddings: {
      provider: "mistral",
      model: "mistral-embed"
    }
  }
}

注意事项

API 访问区域：Mistral API 服务器位于欧洲，中国大陆用户访问可能存在延迟。如有需要，可通过 baseUrl 参数指定中转地址：

{
  providers: {
    mistral: {
      type: "mistral",
      apiKey: "${MISTRAL_API_KEY}",
      baseUrl: "https://your-proxy.example.com/v1"
    }
  }
}

模型版本命名：Mistral 使用 latest 后缀表示当前最新稳定版本，建议在生产环境中固定具体版本号（如 mistral-large-2411），避免因版本更新带来的行为差异。

Voxtral 音频格式：语音转录支持常见音频格式（MP3、WAV、M4A 等），单文件大小限制请参考 Mistral 官方文档。

速率限制与计费：免费套餐有每月 token 上限，超出后需升级付费方案。向量嵌入和语音转录按实际使用量单独计费。