OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

GMI Cloud

GMI Cloud는 OpenAI 호환 API를 통해 프런티어 및 오픈 웨이트 모델을 제공하는 호스팅 추론 플랫폼입니다. OpenClaw에서는 공식 외부 제공자 Plugin입니다. 한 번 설치하고 일반 모델 인증을 통해 자격 증명을 저장한 다음 gmi/google/gemini-3.1-flash-lite와 같은 모델 참조를 사용합니다.

Anthropic, DeepSeek, Google, Moonshot, OpenAI 및 GMI 카탈로그에 공개된 Z.AI 경로를 비롯한 여러 호스팅 모델 제품군에 하나의 API 키를 사용하려면 GMI를 사용하세요. 모델 폴백을 위한 보조 제공자, 여러 공급업체의 호스팅 경로 비교용 제공자 또는 기본 제공자보다 GMI에서 먼저 제공되는 모델을 사용하기 위한 제공자로 활용할 수 있습니다. OpenClaw는 제공자 ID, 인증 프로필, 별칭, 모델 카탈로그 시드 및 기본 URL을 관리하며, GMI는 실시간 모델 가용성, 청구, 사용량 제한 및 모든 제공자 측 라우팅 정책을 관리합니다.

속성 값
제공자 ID gmi(별칭: gmi-cloud, gmicloud)
패키지 @openclaw/gmi-provider
인증 환경 변수 GMI_API_KEY
API OpenAI 호환(openai-completions)
기본 URL https://api.gmi-serving.com/v1
기본 모델 gmi/google/gemini-3.1-flash-lite

설정

Plugin을 설치하고 Gateway를 다시 시작한 다음 GMI Cloud(https://www.gmicloud.ai/)에서 API 키를 생성합니다.

bash
openclaw plugins install @openclaw/gmi-provideropenclaw gateway restart

그런 다음 다음 명령을 실행합니다.

bash
openclaw onboard --auth-choice gmi-api-key

비대화형 설정에서는 --gmi-api-key <key>를 전달하거나 다음과 같이 설정할 수 있습니다.

bash
export GMI_API_KEY="<your-gmi-api-key>" # pragma: allowlist secret

GMI를 선택해야 하는 경우

  • 로컬 모델 서버가 아닌 호스팅 OpenAI 호환 엔드포인트가 필요합니다.
  • 하나의 제공자 계정으로 여러 상용 및 오픈 웨이트 모델 제품군을 사용해 보고 싶습니다.
  • DeepInfra, OpenRouter, Together 또는 공급업체 직접 API와 다른 업스트림 라우팅을 사용하는 폴백 제공자가 필요합니다.
  • GMI 전용 모델 ID, 가격 또는 계정 제어 기능이 필요합니다.

GMI가 OpenAI 호환 경로를 통해 제공하지 않는 공급업체 네이티브 기능이 필요하다면 공급업체 직접 제공자를 선택하세요. 호스팅의 편의성보다 데이터 지역성 또는 로컬 GPU 제어가 더 중요하다면 LM Studio, Ollama, SGLang 또는 vLLM과 같은 로컬 제공자를 선택하세요.

모델

Plugin 카탈로그에는 일반적으로 제공되는 GMI Cloud 경로 ID가 시드로 포함됩니다.

모델 참조 입력 컨텍스트 최대 출력
gmi/anthropic/claude-sonnet-4.6 텍스트 + 이미지 200,000 64,000
gmi/deepseek-ai/DeepSeek-V3.2 텍스트 163,840 65,536
gmi/google/gemini-3.1-flash-lite 텍스트 + 이미지 1,048,576 65,536
gmi/moonshotai/Kimi-K2.5 텍스트 + 이미지 262,144 65,536
gmi/openai/gpt-5.4 텍스트 + 이미지 400,000 128,000
gmi/zai-org/GLM-5.1-FP8 텍스트 202,752 65,536

이 카탈로그는 시드일 뿐, 모든 계정에서 항상 모든 모델을 호출할 수 있다는 보장은 아닙니다. 현재 환경에서 구성된 제공자가 보고하는 모델을 확인하세요.

bash
openclaw models list --provider gmi

문제 해결

  • 401 또는 403: OpenClaw를 실행하는 프로세스에 GMI_API_KEY가 설정되어 있는지 확인하거나, 온보딩을 다시 실행하여 제공자 인증 프로필에 키를 저장하세요.
  • 알 수 없는 모델 오류: GMI 계정에 해당 모델이 있는지 확인하고 openclaw models list --provider gmi에 표시되는 전체 gmi/<route-id> 참조를 사용하세요.
  • 간헐적인 제공자 오류: 다른 GMI 경로를 사용해 보거나 GMI를 유일한 기본 모델 제공자가 아닌 폴백으로 구성하세요.

관련 문서

Was this useful?
On this page

On this page