> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax OpenClaw의 MiniMax 공급자는 기본적으로 **MiniMax M3**를 사용합니다. MiniMax는 다음도 제공합니다. * T2A v2를 통한 번들 음성 합성 * `MiniMax-VL-01`을 통한 번들 이미지 이해 * `music-2.6`을 통한 번들 음악 생성 * MiniMax Token Plan 검색 API를 통한 번들 `web_search` 공급자 구분: | 공급자 ID | 인증 | 기능 | | ---------------- | ----- | -------------------------------------------- | | `minimax` | API 키 | 텍스트, 이미지 생성, 음악 생성, 동영상 생성, 이미지 이해, 음성, 웹 검색 | | `minimax-portal` | OAuth | 텍스트, 이미지 생성, 음악 생성, 동영상 생성, 이미지 이해, 음성 | ## 기본 제공 카탈로그 | 모델 | 유형 | 설명 | | ------------------------ | ------ | -------------------- | | `MiniMax-M3` | 채팅(추론) | 기본 호스팅 추론 모델 | | `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` | 동영상 생성 | 텍스트-동영상 및 이미지 참조 플로 | ## 시작하기 원하는 인증 방식을 선택하고 설정 단계를 따르세요. **권장 대상:** API 키 없이 OAuth를 통해 MiniMax Coding Plan을 빠르게 설정하려는 경우. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice minimax-global-oauth ``` 이는 `api.minimax.io`에 대해 인증합니다. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --provider minimax-portal ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice minimax-cn-oauth ``` 이는 `api.minimaxi.com`에 대해 인증합니다. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --provider minimax-portal ``` OAuth 설정은 `minimax-portal` 공급자 ID를 사용합니다. 모델 참조는 `minimax-portal/MiniMax-M3` 형식을 따릅니다. MiniMax Coding Plan 추천 링크(10% 할인): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb\&source=link) **권장 대상:** Anthropic 호환 API를 사용하는 호스팅 MiniMax. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice minimax-global-api ``` 이는 `api.minimax.io`를 기본 URL로 구성합니다. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --provider minimax ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice minimax-cn-api ``` 이는 `api.minimaxi.com`을 기본 URL로 구성합니다. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --provider minimax ``` ### 구성 예시 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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, }, ], }, }, }, } ``` Anthropic 호환 스트리밍 경로에서 OpenClaw는 사용자가 직접 `thinking`을 명시적으로 설정하지 않는 한 기본적으로 MiniMax M2.x의 thinking을 비활성화합니다. M2.x의 스트리밍 엔드포인트는 네이티브 Anthropic thinking 블록 대신 OpenAI 스타일 델타 청크로 `reasoning_content`를 내보내며, 이를 암묵적으로 활성화해 두면 내부 추론이 표시 출력으로 유출될 수 있습니다. MiniMax-M3 및 향후 호환 M3.x는 이 기본값에서 제외됩니다. M3는 올바른 Anthropic thinking 블록을 내보내고 표시 콘텐츠를 생성하려면 thinking이 활성화되어야 하므로, OpenClaw는 M3를 공급자의 생략/적응형 thinking 경로에 유지합니다. API 키 설정은 `minimax` 공급자 ID를 사용합니다. 모델 참조는 `minimax/MiniMax-M3` 형식을 따릅니다. ## `openclaw configure`로 구성하기 JSON을 편집하지 않고 대화형 구성 마법사를 사용해 MiniMax를 설정하세요. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw configure ``` 메뉴에서 **모델/인증**을 선택합니다. 사용 가능한 MiniMax 옵션 중 하나를 선택합니다. | 인증 선택 | 설명 | | ---------------------- | --------------------- | | `minimax-global-oauth` | 국제 OAuth(Coding Plan) | | `minimax-cn-oauth` | 중국 OAuth(Coding Plan) | | `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를 사용하려면 이미지 생성 공급자로 설정하세요. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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-M3`, `MiniMax-M2.7`, 그리고 `MiniMax-M2.7-highspeed`를 채팅 모델로 구체화합니다. M3는 텍스트와 이미지 입력을 표시합니다. 이미지 이해는 Plugin 소유 `MiniMax-VL-01` 미디어 공급자를 통해 별도로 노출됩니다. 공유 도구 매개변수, 공급자 선택, 장애 조치 동작은 [이미지 생성](/ko/tools/image-generation)을 참조하세요. ### 텍스트 음성 변환 번들 `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`가 포함됩니다. * 인증 해석 순서는 `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 같은 음성 메모 대상은 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.speakerVoiceId` | `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` * 출력 형식: `mp3` * 세션 기반 실행은 `action: "status"`를 포함한 공유 작업/상태 흐름을 통해 분리됩니다 MiniMax를 기본 음악 공급자로 사용하려면: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { musicGenerationModel: { primary: "minimax/music-2.6", }, }, }, } ``` 공유 도구 매개변수, 공급자 선택, 장애 조치 동작은 [음악 생성](/ko/tools/music-generation)을 참조하세요. ### 동영상 생성 번들 MiniMax Plugin은 `minimax`와 `minimax-portal` 모두에 대해 공유 `video_generate` 도구를 통해 동영상 생성을 등록합니다. * 기본 동영상 모델: `minimax/MiniMax-Hailuo-2.3` * OAuth 동영상 모델: `minimax-portal/MiniMax-Hailuo-2.3` * 모드: 텍스트-동영상 및 단일 이미지 참조 흐름 * `aspectRatio` 및 `resolution` 지원 MiniMax를 기본 동영상 공급자로 사용하려면: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3", }, }, }, } ``` 공유 도구 매개변수, 공급자 선택, 장애 조치 동작은 [동영상 생성](/ko/tools/video-generation)을 참조하세요. ### 이미지 이해 MiniMax Plugin은 텍스트 카탈로그와 별도로 이미지 이해를 등록합니다. | 공급자 ID | 기본 이미지 모델 | | ---------------- | --------------- | | `minimax` | `MiniMax-VL-01` | | `minimax-portal` | `MiniMax-VL-01` | 따라서 번들 텍스트 공급자 카탈로그에 M3 이미지 가능 채팅 참조가 포함되어 있어도 자동 미디어 라우팅에서 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` * 호환성 폴백: 이미 토큰 플랜 자격 증명을 가리키는 경우 `MINIMAX_API_KEY` * 리전 재사용: `plugins.entries.minimax.config.webSearch.region`, 그다음 `MINIMAX_API_HOST`, 그다음 MiniMax 공급자 기본 URL * 검색은 공급자 ID `minimax`에 유지됩니다. OAuth CN/글로벌 설정은 `models.providers.minimax-portal.baseUrl`을 통해 간접적으로 리전을 조정할 수 있으며 `MINIMAX_OAUTH_TOKEN`을 통해 bearer 인증을 제공할 수 있습니다 구성은 `plugins.entries.minimax.config.webSearch.*` 아래에 있습니다. 전체 웹 검색 구성과 사용법은 [MiniMax 검색](/ko/tools/minimax-search)을 참조하세요. ## 고급 구성 | 옵션 | 설명 | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | `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` 유지 | `api: "anthropic-messages"`에서 OpenClaw는 params/config에 thinking이 이미 명시적으로 설정되어 있지 않은 한 MiniMax M2.x 모델에 대해 `thinking: { type: "disabled" }`를 주입합니다. 이렇게 하면 M2.x의 스트리밍 엔드포인트가 OpenAI 스타일 델타 청크에서 `reasoning_content`를 내보내 내부 추론이 표시 출력에 노출되는 일을 방지합니다. MiniMax-M3(및 M3.x)는 예외입니다. M3는 적절한 Anthropic thinking 블록을 내보내며 thinking이 비활성화된 경우 `stop_reason: "end_turn"`과 함께 빈 `content` 배열을 반환하므로, 래퍼는 M3를 공급자의 생략/적응형 thinking 경로에 유지합니다. `/fast on` 또는 `params.fastMode: true`는 Anthropic 호환 스트림 경로에서 `MiniMax-M2.7`을 `MiniMax-M2.7-highspeed`로 다시 작성합니다. **가장 적합한 경우:** 가장 강력한 최신 세대 모델을 기본으로 유지하고 MiniMax M2.7로 장애 조치합니다. 아래 예시는 구체적인 기본 모델로 Opus를 사용합니다. 선호하는 최신 세대 기본 모델로 바꾸세요. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 사용량 API: `https://api.minimaxi.com/v1/token_plan/remains` 또는 `https://api.minimax.io/v1/token_plan/remains`(코딩 플랜 키 필요). * 구성된 경우 사용량 폴링은 `models.providers.minimax-portal.baseUrl` 또는 `models.providers.minimax.baseUrl`에서 호스트를 파생하므로 `https://api.minimax.io/anthropic`을 사용하는 글로벌 설정은 `api.minimax.io`를 폴링합니다. 누락되었거나 형식이 잘못된 기본 URL은 호환성을 위해 CN 폴백을 유지합니다. * OpenClaw는 MiniMax 코딩 플랜 사용량을 다른 공급자에서 사용하는 동일한 `% left` 표시로 정규화합니다. MiniMax의 원시 `usage_percent` / `usagePercent` 필드는 소비된 할당량이 아니라 남은 할당량이므로 OpenClaw가 이를 반전합니다. 개수 기반 필드가 있으면 우선합니다. * API가 `model_remains`를 반환하면 OpenClaw는 채팅 모델 항목을 우선하고, 필요한 경우 `start_time` / `end_time`에서 기간 레이블을 파생하며, 코딩 플랜 기간을 더 쉽게 구분할 수 있도록 선택된 모델 이름을 플랜 레이블에 포함합니다. * 사용량 스냅샷은 `minimax`, `minimax-cn`, `minimax-portal`을 동일한 MiniMax 할당량 표면으로 취급하며, Coding Plan 키 env var로 폴백하기 전에 저장된 MiniMax OAuth를 우선합니다. ## 참고 * 모델 참조는 인증 경로를 따릅니다. * API 키 설정: `minimax/` * OAuth 설정: `minimax-portal/` * 기본 채팅 모델: `MiniMax-M3` * 대체 채팅 모델: `MiniMax-M2.7`, `MiniMax-M2.7-highspeed` * 온보딩 및 직접 API 키 설정은 M3와 두 M2.7 변형 모두에 대한 모델 정의를 작성합니다 * 이미지 이해는 Plugin 소유 `MiniMax-VL-01` 미디어 공급자를 사용합니다 * 정확한 비용 추적이 필요하면 `models.json`의 가격 값을 업데이트하세요 * 현재 공급자 ID를 확인하려면 `openclaw models list`를 사용한 다음 `openclaw models set minimax/MiniMax-M3` 또는 `openclaw models set minimax-portal/MiniMax-M3`로 전환하세요 MiniMax Coding Plan 추천 링크(10% 할인): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb\&source=link) 공급자 규칙은 [모델 공급자](/ko/concepts/model-providers)를 참조하세요. ## 문제 해결 이는 보통 **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-M3`, `minimax/MiniMax-M2.7` 또는 `minimax/MiniMax-M2.7-highspeed` * OAuth 경로: `minimax-portal/MiniMax-M3`, `minimax-portal/MiniMax-M2.7` 또는 `minimax-portal/MiniMax-M2.7-highspeed` 그런 다음 다음 명령으로 다시 확인하세요. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list ``` 추가 도움말: [문제 해결](/ko/help/troubleshooting) 및 [FAQ](/ko/help/faq). ## 관련 항목 공급자, 모델 참조, 장애 조치 동작 선택. 공유 이미지 도구 매개변수 및 공급자 선택. 공유 음악 도구 매개변수 및 공급자 선택. 공유 동영상 도구 매개변수 및 공급자 선택. MiniMax Token Plan을 통한 웹 검색 구성. 일반 문제 해결 및 FAQ.