MiniMax

MiniMax는 M2/M2.5 모델 제품군을 개발하는 AI 기업입니다. 현재 코딩에 특화된 릴리스는 MiniMax M2.5(2025년 12월 23일)로, 실제 복잡한 작업을 위해 설계되었습니다.

출처: MiniMax M2.5 릴리스 노트

모델 개요 (M2.5)

MiniMax가 M2.5에서 강조하는 개선 사항:

  • 강화된 다국어 코딩 (Rust, Java, Go, C++, Kotlin, Objective-C, TS/JS).
  • 개선된 웹/앱 개발 및 미적 출력 품질 (네이티브 모바일 포함).
  • 향상된 복합 지시 처리로 사무 스타일 워크플로 지원, 인터리브 사고와 통합 제약 실행 기반.
  • 더 간결한 응답으로 토큰 사용량 감소 및 반복 루프 속도 향상.
  • 강화된 도구/에이전트 프레임워크 호환성 및 컨텍스트 관리 (Claude Code, Droid/Factory AI, Cline, Kilo Code, Roo Code, BlackBox).
  • 향상된 대화 및 기술 문서 출력 품질.

MiniMax M2.5 vs MiniMax M2.5 Highspeed

  • 속도: MiniMax-M2.5-highspeed는 MiniMax 문서의 공식 고속 티어입니다.
  • 비용: MiniMax 가격표에서 highspeed는 동일한 입력 비용과 더 높은 출력 비용이 표시됩니다.
  • 현재 모델 ID: MiniMax-M2.5 또는 MiniMax-M2.5-highspeed를 사용합니다.

설정 방법 선택

MiniMax OAuth (Coding Plan) — 권장

추천 대상: OAuth를 통한 MiniMax Coding Plan 빠른 설정, API 키 불필요.

번들 OAuth 플러그인을 활성화하고 인증합니다:

openclaw plugins enable minimax-portal-auth  # 이미 로드된 경우 생략.
openclaw gateway restart  # 게이트웨이가 이미 실행 중이면 재시작
openclaw onboard --auth-choice minimax-portal

엔드포인트 선택 프롬프트가 표시됩니다:

  • Global - 해외 사용자 (api.minimax.io)
  • CN - 중국 사용자 (api.minimaxi.com)

자세한 내용은 MiniMax OAuth 플러그인 README를 참조하세요.

MiniMax M2.5 (API 키)

추천 대상: Anthropic 호환 API를 사용한 호스팅 MiniMax.

CLI를 통해 설정합니다:

  • openclaw configure 실행
  • Model/auth 선택
  • MiniMax M2.5 선택
{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M2.5" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M2.5",
            name: "MiniMax M2.5",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
          {
            id: "MiniMax-M2.5-highspeed",
            name: "MiniMax M2.5 Highspeed",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

MiniMax M2.5를 폴백으로 (예시)

추천 대상: 최신 세대의 가장 강력한 모델을 기본으로 사용하고, MiniMax M2.5를 폴백으로 설정. 아래 예시는 Opus를 구체적인 기본 모델로 사용하며, 선호하는 최신 세대 기본 모델로 교체 가능합니다.

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

선택 사항: LM Studio를 통한 로컬 실행 (수동)

추천 대상: LM Studio를 사용한 로컬 추론. 강력한 하드웨어(예: 데스크탑/서버)에서 LM Studio의 로컬 서버를 사용하면 MiniMax M2.5에서 좋은 결과를 확인했습니다.

openclaw.json을 통해 수동으로 설정합니다:

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/minimax-m2.5-gs32" },
      models: { "lmstudio/minimax-m2.5-gs32": { alias: "Minimax" } },
    },
  },
  models: {
    mode: "merge",
    providers: {
      lmstudio: {
        baseUrl: "http://127.0.0.1:1234/v1",
        apiKey: "lmstudio",
        api: "openai-responses",
        models: [
          {
            id: "minimax-m2.5-gs32",
            name: "MiniMax M2.5 GS32",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 196608,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

openclaw configure를 통한 설정

대화형 설정 마법사를 사용하면 JSON을 직접 편집하지 않고 MiniMax를 설정할 수 있습니다:

  1. openclaw configure를 실행합니다.
  2. Model/auth를 선택합니다.
  3. MiniMax M2.5를 선택합니다.
  4. 프롬프트에서 기본 모델을 선택합니다.

설정 옵션

  • models.providers.minimax.baseUrl: https://api.minimax.io/anthropic 권장(Anthropic 호환). OpenAI 호환 페이로드를 사용하려면 https://api.minimax.io/v1도 선택 가능합니다.
  • models.providers.minimax.api: anthropic-messages 권장. OpenAI 호환 페이로드를 사용하려면 openai-completions도 선택 가능합니다.
  • 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를 유지합니다.

참고 사항

  • 모델 참조는 minimax/<model> 형식입니다.
  • 권장 모델 ID: MiniMax-M2.5 및 MiniMax-M2.5-highspeed.
  • Coding Plan 사용량 API: https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains (coding plan 키 필요).
  • 정확한 비용 추적이 필요한 경우 models.json의 가격 값을 업데이트하세요.
  • MiniMax Coding Plan 추천 링크 (10% 할인): https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
  • 프로바이더 규칙은 /concepts/model-providers를 참조하세요.
  • openclaw models list와 openclaw models set minimax/MiniMax-M2.5를 사용하여 전환하세요.

문제 해결

”Unknown model: minimax/MiniMax-M2.5”

이 오류는 보통 MiniMax 프로바이더가 설정되지 않은 경우(프로바이더 항목이 없고 MiniMax 인증 프로필/환경 키가 발견되지 않은 경우)에 발생합니다. 이 감지 문제의 수정은 2026.1.12(작성 시점에 미출시)에 포함됩니다. 해결 방법:

  • 2026.1.12로 업그레이드(또는 소스 main에서 실행)한 후 게이트웨이를 재시작합니다.
  • openclaw configure를 실행하고 MiniMax M2.5를 선택하거나,
  • models.providers.minimax 블록을 수동으로 추가하거나,
  • MINIMAX_API_KEY(또는 MiniMax 인증 프로필)를 설정하여 프로바이더가 주입될 수 있도록 합니다.

모델 ID는 대소문자를 구분합니다:

  • minimax/MiniMax-M2.5
  • minimax/MiniMax-M2.5-highspeed

다음으로 다시 확인합니다:

openclaw models list
arrow_back
이전
Glm
다음
Moonshot
arrow_forward