Providers
Mistral
OpenClaw มี Plugin Mistral ที่มาพร้อมในชุด ซึ่งลงทะเบียนสัญญาไว้สี่รายการ ได้แก่ chat completions, การทำความเข้าใจสื่อ (การถอดเสียงแบบชุดของ Voxtral), STT แบบเรียลไทม์สำหรับ Voice Call (Voxtral Realtime) และ memory embeddings (mistral-embed).
| คุณสมบัติ | ค่า |
|---|---|
| รหัสผู้ให้บริการ | mistral |
| Plugin | มาพร้อมในชุด, enabledByDefault: true |
| ตัวแปรสภาพแวดล้อมสำหรับ auth | MISTRAL_API_KEY |
| แฟล็ก onboarding | --auth-choice mistral-api-key |
| แฟล็ก CLI โดยตรง | --mistral-api-key <key> |
| API | เข้ากันได้กับ OpenAI (openai-completions) |
| Base URL | https://api.mistral.ai/v1 |
| โมเดลเริ่มต้น | mistral/mistral-large-latest |
| โมเดล embedding | mistral-embed |
| Voxtral แบบชุด | voxtral-mini-latest (การถอดเสียงเสียง) |
| Voxtral เรียลไทม์ | voxtral-mini-transcribe-realtime-2602 |
เริ่มต้นใช้งาน
รับ API key ของคุณ
สร้าง API key ใน Mistral Console
เรียกใช้ onboarding
openclaw onboard --auth-choice mistral-api-key
หรือส่งคีย์โดยตรง:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
ตั้งค่าโมเดลเริ่มต้น
{
env: { MISTRAL_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
}
ตรวจสอบว่าโมเดลพร้อมใช้งาน
openclaw models list --provider mistral
แคตตาล็อก LLM ในตัว
OpenClaw ปัจจุบันจัดส่งแคตตาล็อก Mistral ที่มาพร้อมในชุดดังนี้:
| การอ้างอิงโมเดล | อินพุต | บริบท | เอาต์พุตสูงสุด | หมายเหตุ |
|---|---|---|---|---|
mistral/mistral-large-latest |
ข้อความ, รูปภาพ | 262,144 | 16,384 | โมเดลเริ่มต้น |
mistral/mistral-medium-2508 |
ข้อความ, รูปภาพ | 262,144 | 8,192 | Mistral Medium 3.1 |
mistral/mistral-small-latest |
ข้อความ, รูปภาพ | 128,000 | 16,384 | Mistral Small 4; ปรับ reasoning ได้ผ่าน API reasoning_effort |
mistral/pixtral-large-latest |
ข้อความ, รูปภาพ | 128,000 | 32,768 | Pixtral |
mistral/codestral-latest |
ข้อความ | 256,000 | 4,096 | การเขียนโค้ด |
mistral/devstral-medium-latest |
ข้อความ | 262,144 | 32,768 | Devstral 2 |
mistral/magistral-small |
ข้อความ | 128,000 | 40,000 | เปิดใช้ reasoning |
การถอดเสียงเสียง (Voxtral)
ใช้ Voxtral สำหรับการถอดเสียงเสียงแบบชุดผ่านไปป์ไลน์การทำความเข้าใจสื่อ
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
},
},
},
}
STT แบบสตรีมสำหรับ Voice Call
Plugin mistral ที่มาพร้อมในชุดลงทะเบียน Voxtral Realtime เป็นผู้ให้บริการ STT แบบสตรีมสำหรับ Voice Call
| การตั้งค่า | พาธการกำหนดค่า | ค่าเริ่มต้น |
|---|---|---|
| API key | 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 |
{
plugins: {
entries: {
"voice-call": {
config: {
streaming: {
enabled: true,
provider: "mistral",
providers: {
mistral: {
apiKey: "${MISTRAL_API_KEY}",
targetStreamingDelayMs: 800,
},
},
},
},
},
},
},
}
การกำหนดค่าขั้นสูง
Reasoning ที่ปรับได้ (mistral-small-latest)
mistral/mistral-small-latest แมปกับ Mistral Small 4 และรองรับ reasoning ที่ปรับได้ บน Chat Completions API ผ่าน reasoning_effort (none ลดการคิดเพิ่มเติมในเอาต์พุตให้น้อยที่สุด; high แสดงร่องรอยการคิดทั้งหมดก่อนคำตอบสุดท้าย)
OpenClaw แมประดับ thinking ของเซสชันไปยัง API ของ Mistral:
| ระดับ thinking ของ OpenClaw | reasoning_effort ของ Mistral |
|---|---|
| off / minimal | none |
| low / medium / high / xhigh / adaptive / max | high |
Memory embeddings
Mistral สามารถให้บริการ memory embeddings ผ่าน /v1/embeddings (โมเดลเริ่มต้น: mistral-embed)
{
memorySearch: { provider: "mistral" },
}
Auth และ base URL
- auth ของ Mistral ใช้
MISTRAL_API_KEY(ส่วนหัว Bearer) - Base URL ของผู้ให้บริการมีค่าเริ่มต้นเป็น
https://api.mistral.ai/v1และยอมรับรูปแบบคำขอ chat-completions มาตรฐานที่เข้ากันได้กับ OpenAI - โมเดลเริ่มต้นสำหรับ onboarding คือ
mistral/mistral-large-latest - แทนที่ base URL ใต้
models.providers.mistral.baseUrlเฉพาะเมื่อ Mistral เผยแพร่ endpoint ระดับภูมิภาคที่คุณต้องใช้ไว้อย่างชัดเจนเท่านั้น