OpenClaw에서 MiniMax M2.1 설정하기: 3분 빠른 연동

새로운 모델을 프로젝트에 도입할 때마다 API를 설정하고 환경 변수를 맞추는 과정이 참 번거롭죠? 특히 텍스트와 이미지를 모두 효율적으로 처리하는 고성능 모델을 찾고 있다면 MiniMax가 좋은 선택지가 될 거예요.

OpenClaw에서 MiniMax를 어떻게 쉽고 빠르게 설정하고 활용할 수 있는지 바로 알려드릴게요. OpenClaw의 MiniMax provider는 기본적으로 MiniMax M2.7을 사용해요.

모델 라인업

MiniMax-M2.7: 기본 호스팅 텍스트 모델이에요.
MiniMax-M2.7-highspeed: 더 빠른 속도를 제공하는 M2.7 텍스트 티어예요.
image-01: 이미지 생성 모델이에요 (생성 및 이미지 투 이미지 편집 지원).

이미지 생성

MiniMax 플러그인은 image_generate 도구에 image-01 모델을 등록해요. 다음 기능들을 지원하고 있어요:

화면 비율 조절이 가능한 Text-to-image 생성.
화면 비율 조절이 가능한 Image-to-image 편집 (subject reference).
지원하는 화면 비율: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9.

MiniMax를 이미지 생성용으로 사용하려면 다음과 같이 이미지 생성 provider로 설정해 주세요:

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

이 플러그인은 텍스트 모델과 동일한 MINIMAX_API_KEY 또는 OAuth 인증을 사용해요. MiniMax가 이미 설정되어 있다면 추가 설정은 필요 없어요.

설정 방식 선택하기

MiniMax OAuth (Coding Plan) - 추천 방식

추천 대상: API 키 없이 OAuth를 통해 MiniMax Coding Plan으로 빠르게 설정하고 싶은 경우.

내장된 OAuth 플러그인을 활성화하고 인증을 진행하세요:

openclaw plugins enable minimax  # skip if already loaded.
openclaw gateway restart  # restart if gateway is already running
openclaw onboard --auth-choice minimax-portal

실행 시 엔드포인트를 선택하라는 메시지가 표시돼요:

Global - 글로벌 사용자용 (api.minimax.io)
CN - 중국 내 사용자용 (api.minimaxi.com)

자세한 내용은 OpenClaw 저장소의 MiniMax 플러그인 패키지 README를 참고해 주세요.

MiniMax M2.7 (API 키 방식)

추천 대상: Anthropic 호환 API를 사용하여 호스팅된 MiniMax를 사용하려는 경우.

CLI를 통해 설정하세요:

openclaw configure 실행
Model/auth 선택
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.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
          {
            id: "MiniMax-M2.7-highspeed",
            name: "MiniMax M2.7 Highspeed",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

MiniMax M2.7을 Fallback으로 사용하기 (예시)

추천 대상: 가장 강력한 최신 세대 모델을 기본(primary)으로 유지하면서, 문제 발생 시 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"],
      },
    },
  },
}

`openclaw configure`로 설정하기

JSON을 직접 수정하지 않고 인터랙티브 설정 마법사를 사용해 MiniMax를 설정할 수 있어요:

openclaw configure를 실행하세요.
Model/auth를 선택하세요.
MiniMax 인증 옵션을 선택하세요.
안내에 따라 기본 모델을 선택하세요.

설정 옵션

models.providers.minimax.baseUrl: Anthropic 호환 방식인 https://api.minimax.io/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: 허용 리스트(allowlist)에 넣고 싶은 모델의 별칭(alias)을 지정해요.
models.mode: 기본 내장 모델과 함께 MiniMax를 추가하려면 merge 상태를 유지하세요.

참고 사항

모델 참조 형식은 minimax/<model>이에요.
기본 텍스트 모델: MiniMax-M2.7.
대체 텍스트 모델: MiniMax-M2.7-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
provider 규칙에 대해서는 /concepts/model-providers를 확인해 주세요.
모델을 전환하려면 openclaw models list와 openclaw models set minimax/MiniMax-M2.7 명령어를 사용하세요.

문제 해결

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

이 메시지는 보통 MiniMax provider가 설정되지 않았음을 의미해요 (provider 항목이 없고 MiniMax 인증 프로필이나 환경 변수 키를 찾을 수 없는 경우). 이 감지 로직에 대한 수정 사항이 2026.1.12 버전에 반영되었어요. 다음 방법으로 해결해 보세요:

2026.1.12 버전으로 업그레이드(또는 main 소스에서 실행)한 후 Gateway를 재시작하세요.
openclaw configure를 실행하고 MiniMax 인증 옵션을 선택하세요.
models.providers.minimax 블록을 수동으로 추가하세요.
MINIMAX_API_KEY(또는 MiniMax 인증 프로필)를 설정하여 provider가 주입될 수 있도록 하세요.

모델 ID는 대소문자를 구분하니 주의해 주세요:

minimax/MiniMax-M2.7
minimax/MiniMax-M2.7-highspeed

설정 후 다음 명령어로 다시 확인해 보세요:

openclaw models list

다음 단계

도움이 필요하신가요? AI Setup Assistant에게 물어보세요!

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.