本页内容
本页内容
供应商
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 |
入门
安装插件
安装自动应用于正在运行的网关;否则下次启动时生效。请参阅 应用更改并检查 。
获取您的 API 密钥
在 Mistral Console 中创建 API 密钥。
运行入门引导培训
或直接传入密钥:
设置默认模型
验证模型是否可用
内置 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 |
更改配置前,请查看插件目录中的对应行:
在不启动 Gateway 的情况下对模型进行烟雾测试:
音频转录(Voxtral)
通过媒体理解管道使用 Voxtral 进行批量音频转录:
语音通话流 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 |
高级配置
可调节推理
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 推理的按模型配置示例:
记忆嵌入
Mistral 可以通过 /v1/embeddings 提供记忆嵌入(默认模型:mistral-embed):
授权和基础 URL
- Mistral 认证使用
MISTRAL_API_KEY(Bearer 头)。 - Provider 基础 URL 默认为
https://api.mistral.ai/v1并接受标准 OpenAI- 兼容聊天完成请求形状。 - 接入引导的默认模型是
mistral/mistral-large-latest。 - 只有当 Mistral 明确发布了你需要的区域端点时,才在
models.providers.mistral.baseUrl下覆盖基础 URL。
相关内容
本页有帮助吗?