Providers
Mistral
OpenClaw에는 네 가지 계약을 등록하는 번들 Mistral Plugin이 포함되어 있습니다: 채팅 완성, 미디어 이해(Voxtral 일괄 전사), Voice Call용 실시간 STT(Voxtral Realtime), 메모리 임베딩(mistral-embed).
| 속성 | 값 |
|---|---|
| Provider id | mistral |
| Plugin | 번들, enabledByDefault: true |
| 인증 env var | MISTRAL_API_KEY |
| 온보딩 플래그 | --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 |
| 임베딩 모델 | mistral-embed |
| Voxtral 일괄 | voxtral-mini-latest(오디오 전사) |
| Voxtral 실시간 | voxtral-mini-transcribe-realtime-2602 |
시작하기
API 키 받기
Mistral Console에서 API 키를 생성합니다.
온보딩 실행
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 카탈로그
Mistral Medium 3.5는 번들 카탈로그의 현재 혼합형 Medium 모델입니다: 128B dense weights,
텍스트 및 이미지 입력, 256K 컨텍스트, 함수 호출, 구조화된 출력, 코딩,
Chat Completions API를 통한 조절 가능한 추론을 지원합니다. 기본 mistral/mistral-large-latest 대신 Mistral의 최신 통합 에이전트형/코딩 모델을 원할 때
mistral/mistral-medium-3-5를 사용하세요.
OpenClaw는 현재 이 번들 Mistral 카탈로그를 제공합니다:
| 모델 참조 | 입력 | 컨텍스트 | 최대 출력 | 참고 |
|---|---|---|---|---|
mistral/mistral-large-latest |
텍스트, 이미지 | 262,144 | 16,384 | 기본 모델 |
mistral/mistral-medium-2508 |
텍스트, 이미지 | 262,144 | 8,192 | Mistral Medium 3.1 |
mistral/mistral-medium-3-5 |
텍스트, 이미지 | 262,144 | 8,192 | Mistral Medium 3.5; 조절 가능한 추론 |
mistral/mistral-small-latest |
텍스트, 이미지 | 128,000 | 16,384 | Mistral Small 4; 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 | 추론 활성화 |
온보딩 후 Gateway를 시작하지 않고 Medium 3.5를 스모크 테스트합니다:
openclaw infer model run --local \ --model mistral/mistral-medium-3-5 \ --prompt "Reply with exactly: mistral-ok" \ --json구성을 변경하기 전에 번들 카탈로그 행을 둘러보려면:
openclaw models list --all --provider mistral --plain오디오 전사(Voxtral)
미디어 이해 파이프라인을 통한 일괄 오디오 전사에는 Voxtral을 사용하세요.
{ tools: { media: { audio: { enabled: true, models: [{ provider: "mistral", model: "voxtral-mini-latest" }], }, }, },}Voice Call 스트리밍 STT
번들 mistral Plugin은 Voxtral Realtime을 Voice Call 스트리밍 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 |
{ plugins: { entries: { "voice-call": { config: { streaming: { enabled: true, provider: "mistral", providers: { mistral: { apiKey: "${MISTRAL_API_KEY}", targetStreamingDelayMs: 800, }, }, }, }, }, }, },}고급 구성
조절 가능한 추론
mistral/mistral-small-latest(Mistral Small 4)와 mistral/mistral-medium-3-5는 Chat Completions API에서 reasoning_effort를 통해 조절 가능한 추론을 지원합니다(none은 출력에서 추가 사고를 최소화하고, high는 최종 답변 전에 전체 사고 추적을 노출합니다). Mistral은 Medium 3.5 에이전트형 및 코드 사용 사례에 reasoning_effort="high"를 권장합니다.
OpenClaw는 세션 thinking 수준을 Mistral API에 매핑합니다:
| OpenClaw thinking 수준 | Mistral reasoning_effort |
|---|---|
| off / minimal | none |
| low / medium / high / xhigh / adaptive / max | high |
Medium 3.5 추론을 위한 모델 범위 구성 예시:
{ agents: { defaults: { model: { primary: "mistral/mistral-medium-3-5" }, models: { "mistral/mistral-medium-3-5": { params: { thinking: "high" }, }, }, }, },}메모리 임베딩
Mistral은 /v1/embeddings를 통해 메모리 임베딩을 제공할 수 있습니다(기본 모델: mistral-embed).
{ memorySearch: { provider: "mistral" },}인증 및 base URL
- Mistral 인증은
MISTRAL_API_KEY(Bearer 헤더)를 사용합니다. - 제공자 base URL의 기본값은
https://api.mistral.ai/v1이며 표준 OpenAI 호환 chat-completions 요청 형태를 허용합니다. - 온보딩 기본 모델은
mistral/mistral-large-latest입니다. - Mistral이 필요한 지역 엔드포인트를 명시적으로 게시한 경우에만
models.providers.mistral.baseUrl아래에서 base URL을 재정의하세요.