OpenClaw Mistral 연동 가이드: 3분 만에 API 설정하기

Mistral

새로운 모델을 도입할 때마다 복잡한 API 설정을 맞추고 코드를 수정하는 일은 꽤나 번거롭죠. 특히 텍스트, 이미지, 오디오 등 여러 모달리티를 동시에 다뤄야 한다면 관리 포인트가 늘어나기 마련이에요. OpenClaw와 Mistral을 조합하면 이런 복잡한 과정을 깔끔하게 해결할 수 있어요.

OpenClaw는 텍스트/이미지 모델 라우팅(mistral/...)과 미디어 이해를 위한 Voxtral 기반 오디오 전사(transcription) 모두에서 Mistral을 지원해요. Mistral은 메모리 임베딩(memorySearch.provider = "mistral")으로도 사용할 수 있어요.

CLI 설정

openclaw onboard --auth-choice mistral-api-key
# or non-interactive
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"

설정 스니펫 (LLM 프로바이더)

{
  env: { MISTRAL_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
}

설정 스니펫 (Voxtral을 이용한 오디오 전사)

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

참고 사항

• Mistral 인증에는 MISTRAL_API_KEY를 사용해요.
• 프로바이더의 기본 URL은 https://api.mistral.ai/v1로 설정되어 있어요.
• 온보딩 시 기본 모델은 mistral/mistral-large-latest예요.
• Mistral의 미디어 이해용 기본 오디오 모델은 voxtral-mini-latest예요.
• 미디어 전사 경로는 /v1/audio/transcriptions를 사용해요.
• 메모리 임베딩 경로는 /v1/embeddings를 사용해요 (기본 모델: mistral-embed).

AI Setup Assistant

다음 단계

• 모델 라우팅 이해하기
• 환경 변수 설정 가이드