Providers
Mistral
OpenClaw bao gồm một Plugin Mistral được đóng gói kèm, đăng ký bốn hợp đồng: hoàn thiện trò chuyện, hiểu phương tiện (phiên âm hàng loạt Voxtral), STT thời gian thực cho Voice Call (Voxtral Realtime), và embedding bộ nhớ (mistral-embed).
| Thuộc tính | Giá trị |
|---|---|
| ID nhà cung cấp | mistral |
| Plugin | được đóng gói kèm, enabledByDefault: true |
| Biến môi trường xác thực | MISTRAL_API_KEY |
| Cờ thiết lập ban đầu | --auth-choice mistral-api-key |
| Cờ CLI trực tiếp | --mistral-api-key <key> |
| API | tương thích OpenAI (openai-completions) |
| URL cơ sở | https://api.mistral.ai/v1 |
| Mô hình mặc định | mistral/mistral-large-latest |
| Mô hình embedding | mistral-embed |
| Voxtral hàng loạt | voxtral-mini-latest (phiên âm âm thanh) |
| Voxtral thời gian thực | voxtral-mini-transcribe-realtime-2602 |
Bắt đầu
Get your API key
Tạo khóa API trong Mistral Console.
Run onboarding
openclaw onboard --auth-choice mistral-api-key
Hoặc truyền khóa trực tiếp:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
Set a default model
{
env: { MISTRAL_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
}
Verify the model is available
openclaw models list --provider mistral
Danh mục LLM tích hợp sẵn
OpenClaw hiện cung cấp danh mục Mistral được đóng gói kèm này:
| Tham chiếu mô hình | Đầu vào | Ngữ cảnh | Đầu ra tối đa | Ghi chú |
|---|---|---|---|---|
mistral/mistral-large-latest |
văn bản, hình ảnh | 262,144 | 16,384 | Mô hình mặc định |
mistral/mistral-medium-2508 |
văn bản, hình ảnh | 262,144 | 8,192 | Mistral Medium 3.1 |
mistral/mistral-small-latest |
văn bản, hình ảnh | 128,000 | 16,384 | Mistral Small 4; suy luận có thể điều chỉnh qua API reasoning_effort |
mistral/pixtral-large-latest |
văn bản, hình ảnh | 128,000 | 32,768 | Pixtral |
mistral/codestral-latest |
văn bản | 256,000 | 4,096 | Lập trình |
mistral/devstral-medium-latest |
văn bản | 262,144 | 32,768 | Devstral 2 |
mistral/magistral-small |
văn bản | 128,000 | 40,000 | Có bật suy luận |
Phiên âm âm thanh (Voxtral)
Dùng Voxtral để phiên âm âm thanh hàng loạt thông qua pipeline hiểu phương tiện.
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
},
},
},
}
STT phát trực tuyến cho Voice Call
Plugin mistral được đóng gói kèm đăng ký Voxtral Realtime làm nhà cung cấp STT phát trực tuyến cho Voice Call.
| Cài đặt | Đường dẫn cấu hình | Mặc định |
|---|---|---|
| Khóa API | plugins.entries.voice-call.config.streaming.providers.mistral.apiKey |
Dùng dự phòng MISTRAL_API_KEY |
| Mô hình | ...mistral.model |
voxtral-mini-transcribe-realtime-2602 |
| Mã hóa | ...mistral.encoding |
pcm_mulaw |
| Tần số lấy mẫu | ...mistral.sampleRate |
8000 |
| Độ trễ mục tiêu | ...mistral.targetStreamingDelayMs |
800 |
{
plugins: {
entries: {
"voice-call": {
config: {
streaming: {
enabled: true,
provider: "mistral",
providers: {
mistral: {
apiKey: "${MISTRAL_API_KEY}",
targetStreamingDelayMs: 800,
},
},
},
},
},
},
},
}
Cấu hình nâng cao
Adjustable reasoning (mistral-small-latest)
mistral/mistral-small-latest ánh xạ tới Mistral Small 4 và hỗ trợ suy luận có thể điều chỉnh trên API Chat Completions qua reasoning_effort (none giảm thiểu suy nghĩ bổ sung trong đầu ra; high hiển thị đầy đủ các vết suy nghĩ trước câu trả lời cuối cùng).
OpenClaw ánh xạ mức thinking của phiên sang API của Mistral:
| Mức thinking của OpenClaw | reasoning_effort của Mistral |
|---|---|
| off / minimal | none |
| low / medium / high / xhigh / adaptive / max | high |
Memory embeddings
Mistral có thể cung cấp embedding bộ nhớ qua /v1/embeddings (mô hình mặc định: mistral-embed).
{
memorySearch: { provider: "mistral" },
}
Auth and base URL
- Xác thực Mistral dùng
MISTRAL_API_KEY(header Bearer). - URL cơ sở của nhà cung cấp mặc định là
https://api.mistral.ai/v1và chấp nhận dạng yêu cầu chat-completions tiêu chuẩn tương thích OpenAI. - Mô hình mặc định khi thiết lập ban đầu là
mistral/mistral-large-latest. - Chỉ ghi đè URL cơ sở trong
models.providers.mistral.baseUrlkhi Mistral công bố rõ ràng một endpoint khu vực mà bạn cần.