MiniMax

번들로 제공되는 minimax Plugin은 두 개의 제공자와 채팅, 이미지 생성, 음악 생성, 동영상 생성, 이미지 이해, 음성(T2A v2), 웹 검색의 일곱 가지 기능을 등록합니다.

기본 제공 카탈로그

모델 참조는 인증 경로를 따릅니다. API 키 설정에서는 minimax/<model>, OAuth 설정에서는 minimax-portal/<model>을 사용합니다.

시작하기

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax

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

openclaw models list --provider minimax

{  env: { MINIMAX_API_KEY: "sk-..." },  agents: { defaults: { model: { primary: "minimax/MiniMax-M3" } } },  models: {    mode: "merge",    providers: {      minimax: {        baseUrl: "https://api.minimax.io/anthropic",        apiKey: "${MINIMAX_API_KEY}",        api: "anthropic-messages",        models: [          {            id: "MiniMax-M3",            name: "MiniMax M3",            reasoning: true,            input: ["text", "image"],            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },            contextWindow: 1000000,            maxTokens: 131072,          },          {            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,          },        ],      },    },  },}

openclaw configure로 구성

openclaw configure

기능

이미지 생성

MiniMax Plugin은 minimax와 minimax-portal 모두에서 image_generate 도구에 image-01 모델을 등록하며, 텍스트 모델과 동일한 MINIMAX_API_KEY 또는 OAuth 인증을 재사용합니다.

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

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

이미지 생성은 항상 MiniMax 전용 이미지 엔드포인트(/v1/image_generation)를 사용하며 models.providers.minimax.baseUrl을 무시합니다. 이 필드는 대신 채팅/Anthropic 호환 기본 URL을 구성하기 때문입니다. 이미지 생성을 중국 엔드포인트로 라우팅하려면 MINIMAX_API_HOST=https://api.minimaxi.com을 설정합니다. 기본 글로벌 엔드포인트는 https://api.minimax.io입니다.

텍스트 음성 변환

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

• 기본 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, speech-01-240228
• 인증 확인 순서: messages.tts.providers.minimax.apiKey, 그다음 minimax-portal OAuth/토큰 인증 프로필, 그다음 Token Plan 환경 키(MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), 마지막으로 MINIMAX_API_KEY
• TTS 호스트가 구성되지 않은 경우 OpenClaw는 구성된 minimax-portal OAuth 호스트를 재사용하고 /anthropic과 같은 Anthropic 호환 경로 접미사를 제거합니다.
• 일반 오디오 첨부 파일은 MP3로 유지됩니다. 음성 메시지 호환 첨부 파일을 요청하는 대상(Feishu, Telegram 및 기타 채널)은 ffmpeg를 사용하여 MiniMax MP3를 48kHz Opus로 트랜스코딩합니다. 예를 들어 Feishu/Lark 파일 API는 네이티브 오디오 메시지에 file_type: "opus"만 허용하기 때문입니다.
• MiniMax T2A는 소수점 speed와 vol을 허용하지만 pitch는 정수로 전송됩니다. OpenClaw는 API 요청 전에 소수점 pitch 값을 버림 처리합니다.

음악 생성

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

• 기본 음악 모델: minimax/music-2.6(OAuth: minimax-portal/music-2.6)
• music-2.6-free, music-cover, music-cover-free도 지원
• 프롬프트 제어 항목: lyrics, instrumental
• 출력 형식: mp3
• 세션 기반 실행은 action: "status"를 포함한 공통 작업/상태 흐름을 통해 분리됩니다.

{  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)
• MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live, I2V-01도 지원
• 모드: 텍스트-동영상 및 단일 이미지 참조 흐름
• resolution 지원(Hailuo 2.3/02 모델에서 768P 또는 1080P), aspectRatio`는 지원되지 않으며 무시됩니다. OC_I18N_900012 공통 도구 매개변수, 제공자 선택 및 장애 조치 동작은 동영상 생성을 참조하세요.

이미지 이해

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

따라서 번들 텍스트 제공자 카탈로그에 이미지 기능을 지원하는 M3 채팅 참조가 포함되어 있어도 자동 미디어 라우팅에서 MiniMax 이미지 이해 기능을 사용할 수 있습니다. PDF 이해 기능은 텍스트 추출에만 MiniMax-M2.7을 사용하며, MiniMax는 PDF를 이미지로 변환하는 경로를 등록하지 않습니다.

웹 검색

MiniMax Plugin은 MiniMax Token Plan 검색 API(/v1/coding_plan/search)를 통해 web_search도 등록합니다.

• 제공자 ID: minimax
• 구조화된 결과: 제목, URL, 스니펫, 관련 검색어
• 권장 환경 변수: MINIMAX_CODE_PLAN_KEY
• 허용되는 환경 변수 별칭: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• 호환성 대체 경로: 이미 토큰 플랜 자격 증명을 가리키는 경우 MINIMAX_API_KEY
• 리전 재사용 순서: plugins.entries.minimax.config.webSearch.region, MINIMAX_API_HOST, MiniMax 제공자 기본 URL
• 검색은 제공자 ID minimax를 유지합니다. OAuth 중국/글로벌 설정은 models.providers.minimax-portal.baseUrl을 통해 간접적으로 리전을 지정할 수 있으며, MINIMAX_OAUTH_TOKEN을 통해 베어러 인증을 제공할 수 있습니다.

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

고급 구성

참고 사항

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

문제 해결

openclaw models list