mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-11 04:10:44 +08:00
oliver
dbbe3add6a
同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。 Made-with: Cursor
134 lines
4.8 KiB
Markdown
134 lines
4.8 KiB
Markdown
---
|
|
summary: "Use Mistral models and Voxtral transcription with OpenClaw"
|
|
read_when:
|
|
- You want to use Mistral models in OpenClaw
|
|
- You need Mistral API key onboarding and model refs
|
|
title: "Mistral"
|
|
---
|
|
|
|
# Mistral
|
|
|
|
OpenClaw supports Mistral for both text/image model routing (`mistral/...`) and
|
|
audio transcription via Voxtral in media understanding.
|
|
Mistral can also be used for memory embeddings (`memorySearch.provider = "mistral"`).
|
|
|
|
- Provider: `mistral`
|
|
- Auth: `MISTRAL_API_KEY`
|
|
- API: Mistral Chat Completions (`https://api.mistral.ai/v1`)
|
|
|
|
## Getting started
|
|
|
|
<Steps>
|
|
<Step title="Get your API key">
|
|
Create an API key in the [Mistral Console](https://console.mistral.ai/).
|
|
</Step>
|
|
<Step title="Run onboarding">
|
|
```bash
|
|
openclaw onboard --auth-choice mistral-api-key
|
|
```
|
|
|
|
Or pass the key directly:
|
|
|
|
```bash
|
|
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
|
|
```
|
|
|
|
</Step>
|
|
<Step title="Set a default model">
|
|
```json5
|
|
{
|
|
env: { MISTRAL_API_KEY: "sk-..." },
|
|
agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
|
|
}
|
|
```
|
|
</Step>
|
|
<Step title="Verify the model is available">
|
|
```bash
|
|
openclaw models list --provider mistral
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Built-in LLM catalog
|
|
|
|
OpenClaw currently ships this bundled Mistral catalog:
|
|
|
|
| Model ref | Input | Context | Max output | Notes |
|
|
| -------------------------------- | ----------- | ------- | ---------- | ---------------------------------------------------------------- |
|
|
| `mistral/mistral-large-latest` | text, image | 262,144 | 16,384 | Default model |
|
|
| `mistral/mistral-medium-2508` | text, image | 262,144 | 8,192 | Mistral Medium 3.1 |
|
|
| `mistral/mistral-small-latest` | text, image | 128,000 | 16,384 | Mistral Small 4; adjustable reasoning via API `reasoning_effort` |
|
|
| `mistral/pixtral-large-latest` | text, image | 128,000 | 32,768 | Pixtral |
|
|
| `mistral/codestral-latest` | text | 256,000 | 4,096 | Coding |
|
|
| `mistral/devstral-medium-latest` | text | 262,144 | 32,768 | Devstral 2 |
|
|
| `mistral/magistral-small` | text | 128,000 | 40,000 | Reasoning-enabled |
|
|
|
|
## Audio transcription (Voxtral)
|
|
|
|
Use Voxtral for audio transcription through the media understanding pipeline.
|
|
|
|
```json5
|
|
{
|
|
tools: {
|
|
media: {
|
|
audio: {
|
|
enabled: true,
|
|
models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
<Tip>
|
|
The media transcription path uses `/v1/audio/transcriptions`. The default audio model for Mistral is `voxtral-mini-latest`.
|
|
</Tip>
|
|
|
|
## Advanced configuration
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="Adjustable reasoning (mistral-small-latest)">
|
|
`mistral/mistral-small-latest` maps to Mistral Small 4 and supports [adjustable reasoning](https://docs.mistral.ai/capabilities/reasoning/adjustable) on the Chat Completions API via `reasoning_effort` (`none` minimizes extra thinking in the output; `high` surfaces full thinking traces before the final answer).
|
|
|
|
OpenClaw maps the session **thinking** level to Mistral's API:
|
|
|
|
| OpenClaw thinking level | Mistral `reasoning_effort` |
|
|
| ------------------------------------------------ | -------------------------- |
|
|
| **off** / **minimal** | `none` |
|
|
| **low** / **medium** / **high** / **xhigh** / **adaptive** | `high` |
|
|
|
|
<Note>
|
|
Other bundled Mistral catalog models do not use this parameter. Keep using `magistral-*` models when you want Mistral's native reasoning-first behavior.
|
|
</Note>
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="Memory embeddings">
|
|
Mistral can serve memory embeddings via `/v1/embeddings` (default model: `mistral-embed`).
|
|
|
|
```json5
|
|
{
|
|
memorySearch: { provider: "mistral" },
|
|
}
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="Auth and base URL">
|
|
- Mistral auth uses `MISTRAL_API_KEY`.
|
|
- Provider base URL defaults to `https://api.mistral.ai/v1`.
|
|
- Onboarding default model is `mistral/mistral-large-latest`.
|
|
- Z.AI uses Bearer auth with your API key.
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
## Related
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Model selection" href="/concepts/model-providers" icon="layers">
|
|
Choosing providers, model refs, and failover behavior.
|
|
</Card>
|
|
<Card title="Media understanding" href="/tools/media-understanding" icon="microphone">
|
|
Audio transcription setup and provider selection.
|
|
</Card>
|
|
</CardGroup>
|