Providers

Mistral

OpenClaw에는 채팅 완성, 미디어 이해(Voxtral 일괄 전사), 음성 통화용 실시간 STT(Voxtral Realtime), 메모리 임베딩(mistral-embed)이라는 네 가지 계약을 등록하는 번들 Mistral Plugin이 포함되어 있습니다.

속성
제공자 ID mistral
Plugin 번들 제공, enabledByDefault: true
인증 환경 변수 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 키를 생성합니다.

  • 온보딩 실행

    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; 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 추론 활성화

    오디오 전사(Voxtral)

    미디어 이해 파이프라인을 통한 일괄 오디오 전사에는 Voxtral을 사용합니다.

    {
      tools: {
        media: {
          audio: {
            enabled: true,
            models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
          },
        },
      },
    }
    

    음성 통화 스트리밍 STT

    번들 mistral Plugin은 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
    {
      plugins: {
        entries: {
          "voice-call": {
            config: {
              streaming: {
                enabled: true,
                provider: "mistral",
                providers: {
                  mistral: {
                    apiKey: "${MISTRAL_API_KEY}",
                    targetStreamingDelayMs: 800,
                  },
                },
              },
            },
          },
        },
      },
    }
    

    고급 구성

    조정 가능한 추론(mistral-small-latest)

    mistral/mistral-small-latest는 Mistral Small 4에 매핑되며, Chat Completions API에서 reasoning_effort를 통해 조정 가능한 추론을 지원합니다(none은 출력에서 추가 사고를 최소화하고, high는 최종 답변 전에 전체 사고 흔적을 표시합니다).

    OpenClaw는 세션 사고 수준을 Mistral의 API에 매핑합니다.

    OpenClaw 사고 수준 Mistral reasoning_effort
    off / minimal none
    low / medium / high / xhigh / adaptive / max high
    메모리 임베딩

    Mistral은 /v1/embeddings를 통해 메모리 임베딩을 제공할 수 있습니다(기본 모델: mistral-embed).

    {
      memorySearch: { provider: "mistral" },
    }
    
    인증 및 기본 URL
    • Mistral 인증은 MISTRAL_API_KEY를 사용합니다(Bearer 헤더).
    • 제공자 기본 URL은 https://api.mistral.ai/v1이며 표준 OpenAI 호환 chat-completions 요청 형태를 허용합니다.
    • 온보딩 기본 모델은 mistral/mistral-large-latest입니다.
    • Mistral이 필요한 지역 엔드포인트를 명시적으로 게시한 경우에만 models.providers.mistral.baseUrl에서 기본 URL을 재정의하세요.

    관련 항목