GMI Cloud

GMI Cloud é uma plataforma hospedada de inferência para modelos de fronteira e de pesos abertos por meio de uma API compatível com a OpenAI. No OpenClaw, ela é um Plugin oficial de provedor externo: instale-o uma vez, armazene as credenciais por meio da autenticação normal de modelos e use referências de modelo como gmi/google/gemini-3.1-flash-lite.

Use a GMI quando quiser uma única chave de API para várias famílias de modelos hospedados, incluindo rotas da Anthropic, DeepSeek, Google, Moonshot, OpenAI e Z.AI disponibilizadas pelo catálogo da GMI. Ela funciona como provedor secundário para fallback de modelos, para comparar rotas hospedadas entre fornecedores ou quando a GMI disponibiliza um modelo antes do seu provedor principal. O OpenClaw é responsável pelo identificador do provedor, perfil de autenticação, aliases, semente do catálogo de modelos e URL base; a GMI é responsável pela disponibilidade dos modelos em tempo real, cobrança, limites de taxa e quaisquer políticas de roteamento do lado do provedor.

Configuração

Instale o Plugin, reinicie o Gateway e crie uma chave de API na GMI Cloud (https://www.gmicloud.ai/):

openclaw plugins install @openclaw/gmi-provideropenclaw gateway restart

Em seguida, execute:

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

Configurações não interativas podem passar --gmi-api-key <key> ou definir:

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

Quando escolher a GMI

• Você quer um endpoint hospedado compatível com a OpenAI em vez de um servidor local de modelos.
• Você quer experimentar várias famílias de modelos comerciais e de pesos abertos por meio de uma única conta de provedor.
• Você quer um provedor de fallback com roteamento upstream diferente do DeepInfra, OpenRouter, Together ou das APIs diretas dos fornecedores.
• Você precisa de identificadores de modelos, preços ou controles de conta específicos da GMI.

Escolha o provedor direto do fornecedor quando precisar de recursos nativos do fornecedor que a GMI não disponibiliza por sua rota compatível com a OpenAI. Escolha um provedor local, como LM Studio, Ollama, SGLang ou vLLM, quando a localidade dos dados ou o controle local da GPU for mais importante do que a conveniência da hospedagem.

Modelos

O catálogo do Plugin fornece como semente identificadores de rotas comumente disponíveis na GMI Cloud:

O catálogo é uma semente, não uma garantia de que todas as contas possam acessar todos os modelos o tempo todo. Liste o que o provedor configurado informa no seu ambiente:

openclaw models list --provider gmi

Solução de problemas

• 401 ou 403: verifique se GMI_API_KEY está definida para o processo que executa o OpenClaw ou execute novamente a integração inicial para armazenar a chave no perfil de autenticação do provedor.
• Erros de modelo desconhecido: confirme se o modelo existe na sua conta da GMI e use a referência completa gmi/<route-id> exibida por openclaw models list --provider gmi.
• Erros intermitentes do provedor: experimente uma rota diferente da GMI ou configure a GMI como fallback, em vez de usá-la como o único provedor principal de modelos.

Relacionado

• Provedores de modelos
• Todos os provedores