MiniMax

OpenClaw의 MiniMax 공급자는 기본값으로 MiniMax M2.7을 사용합니다. MiniMax는 다음도 제공합니다.

T2A v2를 통한 번들 음성 합성
MiniMax-VL-01을 통한 번들 이미지 이해
music-2.6을 통한 번들 음악 생성
MiniMax Token Plan 검색 API를 통한 번들 web_search

공급자 분리:

공급자 ID	인증	기능
`minimax`	API 키	텍스트, 이미지 생성, 음악 생성, 비디오 생성, 이미지 이해, 음성, 웹 검색
`minimax-portal`	OAuth	텍스트, 이미지 생성, 음악 생성, 비디오 생성, 이미지 이해, 음성

내장 카탈로그

모델	유형	설명
`MiniMax-M2.7`	채팅(추론)	기본 호스팅 추론 모델
`MiniMax-M2.7-highspeed`	채팅(추론)	더 빠른 M2.7 추론 티어
`MiniMax-VL-01`	비전	이미지 이해 모델
`image-01`	이미지 생성	텍스트-이미지 및 이미지-이미지 편집
`music-2.6`	음악 생성	기본 음악 모델
`music-2.5`	음악 생성	이전 음악 생성 티어
`music-2.0`	음악 생성	레거시 음악 생성 티어
`MiniMax-Hailuo-2.3`	비디오 생성	텍스트-비디오 및 이미지 참조 플로

시작하기

선호하는 인증 방식을 선택하고 설정 단계를 따르세요.

OAuth (Coding Plan)
API key

적합한 용도: API 키 없이 OAuth를 통해 MiniMax Coding Plan을 빠르게 설정합니다.

International
China

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth

이는 api.minimax.io에 대해 인증합니다.

Verify the model is available

openclaw models list --provider minimax-portal

Run onboarding

openclaw onboard --auth-choice minimax-cn-oauth

이는 api.minimaxi.com에 대해 인증합니다.

Verify the model is available

openclaw models list --provider minimax-portal

OAuth 설정은 minimax-portal 공급자 ID를 사용합니다. 모델 참조는 minimax-portal/MiniMax-M2.7 형식을 따릅니다.

MiniMax Coding Plan 추천 링크(10% 할인): MiniMax Coding Plan

적합한 용도: Anthropic 호환 API를 사용하는 호스팅 MiniMax.

International
China

Run onboarding

openclaw onboard --auth-choice minimax-global-api

이는 api.minimax.io를 기본 URL로 구성합니다.

Verify the model is available

openclaw models list --provider minimax

Run onboarding

openclaw onboard --auth-choice minimax-cn-api

이는 api.minimaxi.com을 기본 URL로 구성합니다.

Verify the model is available

openclaw models list --provider minimax

구성 예시

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M2.7" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M2.7",
            name: "MiniMax M2.7",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
          {
            id: "MiniMax-M2.7-highspeed",
            name: "MiniMax M2.7 Highspeed",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

Anthropic 호환 스트리밍 경로에서 OpenClaw는 사용자가 직접 thinking을 명시적으로 설정하지 않는 한 기본적으로 MiniMax thinking을 비활성화합니다. MiniMax의 스트리밍 엔드포인트는 네이티브 Anthropic thinking 블록 대신 OpenAI 스타일 델타 청크로 reasoning_content를 내보내며, 암시적으로 활성화된 상태로 두면 내부 추론이 표시 출력에 노출될 수 있습니다.

API 키 설정은 minimax 공급자 ID를 사용합니다. 모델 참조는 minimax/MiniMax-M2.7 형식을 따릅니다.

`openclaw configure`로 구성하기

JSON을 편집하지 않고 대화형 구성 마법사를 사용해 MiniMax를 설정하세요:

마법사 실행

openclaw configure

모델/인증 선택

메뉴에서 모델/인증을 선택합니다.

MiniMax 인증 옵션 선택

사용 가능한 MiniMax 옵션 중 하나를 선택합니다.

인증 선택지	설명
`minimax-global-oauth`	국제 OAuth(코딩 플랜)
`minimax-cn-oauth`	중국 OAuth(코딩 플랜)
`minimax-global-api`	국제 API 키
`minimax-cn-api`	중국 API 키

기본 모델 선택

메시지가 표시되면 기본 모델을 선택합니다.

기능

이미지 생성

MiniMax Plugin은 image_generate 도구에 image-01 모델을 등록합니다. 지원하는 기능은 다음과 같습니다.

종횡비 제어가 포함된 텍스트-이미지 생성
종횡비 제어가 포함된 이미지-이미지 편집(피사체 참조)
요청당 최대 9개의 출력 이미지
편집 요청당 최대 1개의 참조 이미지
지원되는 종횡비: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

이미지 생성에 MiniMax를 사용하려면 이미지 생성 제공자로 설정합니다.

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

Plugin은 텍스트 모델과 동일한 MINIMAX_API_KEY 또는 OAuth 인증을 사용합니다. MiniMax가 이미 설정되어 있으면 추가 구성이 필요하지 않습니다. minimax와 minimax-portal 모두 동일한 image-01 모델로 image_generate를 등록합니다. API 키 설정은 MINIMAX_API_KEY를 사용하고, OAuth 설정은 번들된 minimax-portal 인증 경로를 대신 사용할 수 있습니다. 이미지 생성은 항상 MiniMax의 전용 이미지 엔드포인트 (/v1/image_generation)를 사용하며 models.providers.minimax.baseUrl은 무시합니다. 해당 필드는 채팅/Anthropic 호환 기본 URL을 구성하기 때문입니다. 이미지 생성을 CN 엔드포인트를 통해 라우팅하려면 MINIMAX_API_HOST=https://api.minimaxi.com을 설정합니다. 기본 글로벌 엔드포인트는 https://api.minimax.io입니다. 온보딩 또는 API 키 설정이 명시적인 models.providers.minimax 항목을 작성하면 OpenClaw는 MiniMax-M2.7과 MiniMax-M2.7-highspeed를 텍스트 전용 채팅 모델로 구체화합니다. 이미지 이해는 Plugin 소유의 MiniMax-VL-01 미디어 제공자를 통해 별도로 노출됩니다.

공유 도구 매개변수, 제공자 선택, 장애 조치 동작은 이미지 생성을 참조하세요.

텍스트 음성 변환

번들된 minimax Plugin은 messages.tts용 음성 제공자로 MiniMax T2A v2를 등록합니다.

기본 TTS 모델: speech-2.8-hd
기본 음성: English_expressive_narrator
지원되는 번들 모델 ID에는 speech-2.8-hd, speech-2.8-turbo, speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo, speech-01-hd, speech-01-turbo가 포함됩니다.
인증 확인 순서는 messages.tts.providers.minimax.apiKey, 그다음 minimax-portal OAuth/토큰 인증 프로필, 그다음 토큰 플랜 환경 키(MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), 그다음 MINIMAX_API_KEY입니다.
TTS 호스트가 구성되어 있지 않으면 OpenClaw는 구성된 minimax-portal OAuth 호스트를 재사용하고 /anthropic 같은 Anthropic 호환 경로 접미사를 제거합니다.
일반 오디오 첨부 파일은 MP3로 유지됩니다.
Feishu 및 Telegram 같은 음성 메모 대상은 MiniMax MP3에서 ffmpeg를 사용해 48kHz Opus로 트랜스코딩됩니다. Feishu/Lark 파일 API가 네이티브 오디오 메시지에 file_type: "opus"만 허용하기 때문입니다.
MiniMax T2A는 소수 speed와 vol을 허용하지만 pitch는 정수로 전송됩니다. OpenClaw는 API 요청 전에 소수 pitch 값을 잘라냅니다.

설정	환경 변수	기본값	설명
`messages.tts.providers.minimax.baseUrl`	`MINIMAX_API_HOST`	`https://api.minimax.io`	MiniMax T2A API 호스트.
`messages.tts.providers.minimax.model`	`MINIMAX_TTS_MODEL`	`speech-2.8-hd`	TTS 모델 ID.
`messages.tts.providers.minimax.voiceId`	`MINIMAX_TTS_VOICE_ID`	`English_expressive_narrator`	음성 출력에 사용되는 음성 ID.
`messages.tts.providers.minimax.speed`		`1.0`	재생 속도, `0.5..2.0`.
`messages.tts.providers.minimax.vol`		`1.0`	볼륨, `(0, 10]`.
`messages.tts.providers.minimax.pitch`		`0`	정수 피치 이동, `-12..12`.

음악 생성

번들된 MiniMax Plugin은 minimax와 minimax-portal 모두에 대해 공유 music_generate 도구를 통해 음악 생성을 등록합니다.

기본 음악 모델: minimax/music-2.6
OAuth 음악 모델: minimax-portal/music-2.6
minimax/music-2.5 및 minimax/music-2.0도 지원
프롬프트 제어: lyrics, instrumental, durationSeconds
출력 형식: mp3
세션 기반 실행은 action: "status"를 포함하여 공유 작업/상태 흐름을 통해 분리됩니다.

MiniMax를 기본 음악 제공자로 사용하려면 다음과 같이 설정합니다.

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}

공유 도구 매개변수, 제공자 선택, 장애 조치 동작은 음악 생성을 참조하세요.

동영상 생성

번들된 MiniMax Plugin은 minimax와 minimax-portal 모두에 대해 공유 video_generate 도구를 통해 동영상 생성을 등록합니다.

기본 동영상 모델: minimax/MiniMax-Hailuo-2.3
OAuth 동영상 모델: minimax-portal/MiniMax-Hailuo-2.3
모드: 텍스트-동영상 및 단일 이미지 참조 흐름
aspectRatio 및 resolution 지원

MiniMax를 기본 동영상 제공자로 사용하려면 다음과 같이 설정합니다.

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}

공유 도구 매개변수, 제공자 선택, 장애 조치 동작은 동영상 생성을 참조하세요.

이미지 이해

MiniMax Plugin은 이미지 이해를 텍스트 카탈로그와 별도로 등록합니다.

제공자 ID	기본 이미지 모델
`minimax`	`MiniMax-VL-01`
`minimax-portal`	`MiniMax-VL-01`

이 때문에 번들 텍스트 제공자 카탈로그가 여전히 텍스트 전용 M2.7 채팅 참조를 표시하더라도 자동 미디어 라우팅은 MiniMax 이미지 이해를 사용할 수 있습니다.

웹 검색

MiniMax Plugin은 MiniMax Token Plan 검색 API를 통해 web_search도 등록합니다.

제공자 ID: minimax
구조화된 결과: 제목, URL, 스니펫, 관련 쿼리
권장 env var: MINIMAX_CODE_PLAN_KEY
허용되는 env 별칭: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
호환성 대체: 이미 token-plan 자격 증명을 가리키는 경우 MINIMAX_API_KEY
리전 재사용: plugins.entries.minimax.config.webSearch.region, 그다음 MINIMAX_API_HOST, 그다음 MiniMax 제공자 기본 URL
검색은 제공자 ID minimax에 유지됩니다. OAuth CN/global 설정은 models.providers.minimax-portal.baseUrl을 통해 리전을 간접적으로 조정할 수 있으며 MINIMAX_OAUTH_TOKEN을 통해 bearer 인증을 제공할 수 있습니다.

구성은 plugins.entries.minimax.config.webSearch.* 아래에 있습니다.

전체 웹 검색 구성 및 사용법은 MiniMax 검색을 참조하세요.

고급 구성

구성 옵션

옵션	설명
`models.providers.minimax.baseUrl`	`https://api.minimax.io/anthropic`(Anthropic 호환)을 권장합니다. `https://api.minimax.io/v1`은 OpenAI 호환 페이로드에 선택적으로 사용할 수 있습니다.
`models.providers.minimax.api`	`anthropic-messages`를 권장합니다. `openai-completions`는 OpenAI 호환 페이로드에 선택적으로 사용할 수 있습니다.
`models.providers.minimax.apiKey`	MiniMax API 키(`MINIMAX_API_KEY`)
`models.providers.minimax.models`	`id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost`를 정의합니다.
`agents.defaults.models`	허용 목록에 넣을 모델의 별칭을 지정합니다.
`models.mode`	기본 제공 항목과 함께 MiniMax를 추가하려면 `merge`를 유지합니다.

Thinking 기본값

api: "anthropic-messages"에서는 params/config에 thinking이 이미 명시적으로 설정되어 있지 않은 한 OpenClaw가 thinking: { type: "disabled" }를 주입합니다.이렇게 하면 MiniMax의 스트리밍 엔드포인트가 OpenAI 스타일 델타 청크에서 reasoning_content를 내보내 내부 reasoning이 표시 출력으로 누출되는 것을 방지합니다.

빠른 모드

/fast on 또는 params.fastMode: true는 Anthropic 호환 스트림 경로에서 MiniMax-M2.7을 MiniMax-M2.7-highspeed로 다시 씁니다.

대체 예시

가장 적합한 경우: 가장 강력한 최신 세대 모델을 기본으로 유지하고, MiniMax M2.7로 장애 조치합니다. 아래 예시는 구체적인 기본 모델로 Opus를 사용합니다. 선호하는 최신 세대 기본 모델로 바꾸세요.

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "primary" },
        "minimax/MiniMax-M2.7": { alias: "minimax" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["minimax/MiniMax-M2.7"],
      },
    },
  },
}

Coding Plan 사용 세부 정보

Coding Plan 사용량 API: https://api.minimaxi.com/v1/token_plan/remains 또는 https://api.minimax.io/v1/token_plan/remains(coding plan 키 필요).
사용량 폴링은 구성된 경우 models.providers.minimax-portal.baseUrl 또는 models.providers.minimax.baseUrl에서 호스트를 파생하므로, https://api.minimax.io/anthropic을 사용하는 global 설정은 api.minimax.io를 폴링합니다. 누락되었거나 잘못된 형식의 기본 URL은 호환성을 위해 CN 대체를 유지합니다.
OpenClaw는 MiniMax coding-plan 사용량을 다른 제공자와 동일한 % left 표시로 정규화합니다. MiniMax의 원시 usage_percent / usagePercent 필드는 사용된 할당량이 아니라 남은 할당량이므로 OpenClaw가 이를 반전합니다. 개수 기반 필드가 있으면 우선합니다.
API가 model_remains를 반환하면 OpenClaw는 채팅 모델 항목을 선호하고, 필요할 때 start_time / end_time에서 창 레이블을 파생하며, coding-plan 창을 더 쉽게 구분할 수 있도록 선택한 모델 이름을 플랜 레이블에 포함합니다.
사용량 스냅샷은 minimax, minimax-cn, minimax-portal을 동일한 MiniMax 할당량 표면으로 취급하며, Coding Plan 키 env var로 대체하기 전에 저장된 MiniMax OAuth를 선호합니다.

참고 사항

모델 참조는 인증 경로를 따릅니다.
- API 키 설정: minimax/<model>
- OAuth 설정: minimax-portal/<model>
기본 채팅 모델: MiniMax-M2.7
대체 채팅 모델: MiniMax-M2.7-highspeed
온보딩 및 직접 API 키 설정은 두 M2.7 변형 모두에 대해 텍스트 전용 모델 정의를 작성합니다.
이미지 이해는 Plugin 소유 MiniMax-VL-01 미디어 제공자를 사용합니다.
정확한 비용 추적이 필요하면 models.json의 가격 값을 업데이트하세요.
현재 제공자 ID를 확인하려면 openclaw models list를 사용한 다음, openclaw models set minimax/MiniMax-M2.7 또는 openclaw models set minimax-portal/MiniMax-M2.7로 전환하세요.

MiniMax Coding Plan 추천 링크(10% 할인): MiniMax Coding Plan

제공자 규칙은 모델 제공자를 참조하세요.

문제 해결

"알 수 없는 모델: minimax/MiniMax-M2.7"

이는 일반적으로 MiniMax 제공자가 구성되지 않았음을 의미합니다(일치하는 제공자 항목이 없고 MiniMax 인증 프로필/env 키도 없음). 이 감지에 대한 수정은 2026.1.12에 포함되어 있습니다. 해결 방법:

2026.1.12로 업그레이드하거나 소스 main에서 실행한 다음 Gateway를 다시 시작합니다.
openclaw configure를 실행하고 MiniMax 인증 옵션을 선택하거나,
일치하는 models.providers.minimax 또는 models.providers.minimax-portal 블록을 수동으로 추가하거나,
일치하는 제공자를 주입할 수 있도록 MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN 또는 MiniMax 인증 프로필을 설정합니다.

모델 ID는 대소문자를 구분한다는 점을 확인하세요.

API 키 경로: minimax/MiniMax-M2.7 또는 minimax/MiniMax-M2.7-highspeed
OAuth 경로: minimax-portal/MiniMax-M2.7 또는 minimax-portal/MiniMax-M2.7-highspeed

그런 다음 다음으로 다시 확인합니다.

openclaw models list

추가 도움말: 문제 해결 및 FAQ.

모델 선택

제공자, 모델 참조, 장애 조치 동작 선택.

이미지 생성

공유 이미지 도구 매개변수 및 제공자 선택.

음악 생성

공유 음악 도구 매개변수 및 제공자 선택.

동영상 생성

공유 동영상 도구 매개변수 및 제공자 선택.

MiniMax 검색

MiniMax Token Plan을 통한 웹 검색 구성.

문제 해결

일반 문제 해결 및 FAQ.

Overview

Concepts and configuration

Providers

내장 카탈로그

시작하기

구성 예시

`openclaw configure`로 구성하기

기능

이미지 생성

텍스트 음성 변환

음악 생성

동영상 생성

이미지 이해

웹 검색

고급 구성

참고 사항

문제 해결

관련 항목

모델 선택

이미지 생성

음악 생성

동영상 생성

MiniMax 검색

문제 해결

Overview

Concepts and configuration

Providers

Documentation Index

​내장 카탈로그

​시작하기

​구성 예시

​openclaw configure로 구성하기

​기능

​이미지 생성

​텍스트 음성 변환

​음악 생성

​동영상 생성

​이미지 이해

​웹 검색

​고급 구성

​참고 사항

​문제 해결

​관련 항목

모델 선택

이미지 생성

음악 생성

동영상 생성

MiniMax 검색

문제 해결

내장 카탈로그

시작하기

구성 예시

`openclaw configure`로 구성하기

기능

이미지 생성

텍스트 음성 변환

음악 생성

동영상 생성

이미지 이해

웹 검색

고급 구성

참고 사항

문제 해결

관련 항목