MiniMax

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

MiniMax는 다음도 제공합니다.

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

공급자 분리:

# 내장 카탈로그

# 시작하기

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

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-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,
          },
        ],
      },
    },
  },
}

# openclaw configure로 구성하기

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

openclaw configure

# 기능

# 이미지 생성

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 값을 잘라냅니다.

# 음악 생성

번들된 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은 이미지 이해를 텍스트 카탈로그와 별도로 등록합니다.

이 때문에 번들 텍스트 제공자 카탈로그가 여전히 텍스트 전용 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.* 아래에 있습니다.

# 고급 구성

{
  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"],
      },
    },
  },
}

# 참고 사항

• 모델 참조는 인증 경로를 따릅니다.
  • 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로 전환하세요.

# 문제 해결

openclaw models list

# 관련 항목