Providers
GLM (Zhipu)
GLM é uma família de modelos (não uma empresa) disponível pela plataforma Z.AI. No OpenClaw, os modelos GLM são acessados pelo provedor zai incluído, com refs como zai/glm-5.1.
| Propriedade | Valor |
|---|---|
| ID do provedor | zai |
| Plugin | incluído, enabledByDefault: true |
| Variáveis de ambiente de autenticação | ZAI_API_KEY ou Z_AI_API_KEY |
| Opções de onboarding | zai-api-key, zai-coding-global, zai-coding-cn, zai-global, zai-cn |
| API | compatível com OpenAI |
| URL base padrão | https://api.z.ai/api/paas/v4 |
| Padrão sugerido | zai/glm-5.1 |
| Modelo de imagem padrão | zai/glm-4.6v |
Primeiros passos
Escolha uma rota de autenticação e execute o onboarding
Escolha a opção de onboarding que corresponda ao seu plano e à sua região da Z.AI. A opção genérica zai-api-key detecta automaticamente o endpoint correspondente pelo formato da chave; use as opções regionais explícitas quando quiser forçar um Coding Plan específico ou a superfície de API geral.
| Opção de autenticação | Melhor para |
|---|---|
zai-api-key |
Chave de API genérica com detecção automática de endpoint |
zai-coding-global |
Usuários do Coding Plan (global) |
zai-coding-cn |
Usuários do Coding Plan (região da China) |
zai-global |
API geral (global) |
zai-cn |
API geral (região da China) |
openclaw onboard --auth-choice zai-api-key
openclaw onboard --auth-choice zai-coding-global
openclaw onboard --auth-choice zai-coding-cn
openclaw onboard --auth-choice zai-global
openclaw onboard --auth-choice zai-cn
Defina GLM como o modelo padrão
openclaw config set agents.defaults.model.primary "zai/glm-5.1"
Verifique se os modelos estão disponíveis
openclaw models list --provider zai
Exemplo de configuração
{
env: { ZAI_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
Catálogo integrado
O provedor zai incluído semeia 13 refs de modelos GLM. Todas as entradas aceitam raciocínio, salvo indicação em contrário; glm-5v-turbo e glm-4.6v aceitam entrada de imagem além de texto.
| Ref do modelo | Observações |
|---|---|
zai/glm-5.1 |
Modelo padrão. Raciocínio, somente texto, contexto de 202k. |
zai/glm-5 |
Raciocínio, somente texto, contexto de 202k. |
zai/glm-5-turbo |
Raciocínio, somente texto, contexto de 202k. |
zai/glm-5v-turbo |
Raciocínio, texto + imagem, contexto de 202k. |
zai/glm-4.7 |
Raciocínio, somente texto, contexto de 204k. |
zai/glm-4.7-flash |
Raciocínio, somente texto, contexto de 200k. |
zai/glm-4.7-flashx |
Raciocínio, somente texto. |
zai/glm-4.6 |
Raciocínio, somente texto. |
zai/glm-4.6v |
Raciocínio, texto + imagem. Modelo de imagem padrão. |
zai/glm-4.5 |
Raciocínio, somente texto. |
zai/glm-4.5-air |
Raciocínio, somente texto. |
zai/glm-4.5-flash |
Raciocínio, somente texto. |
zai/glm-4.5v |
Raciocínio, texto + imagem. |
Configuração avançada
Detecção automática de endpoint
Quando você usa a opção de autenticação zai-api-key, o OpenClaw inspeciona o formato da chave para determinar a URL base correta da Z.AI. As opções regionais explícitas (zai-coding-global, zai-coding-cn, zai-global, zai-cn) substituem a detecção automática e fixam diretamente o endpoint.
Detalhes do provedor
Os modelos GLM são servidos pelo provedor de runtime zai. Para ver a configuração completa do provedor, endpoints regionais e recursos adicionais, consulte a página do provedor Z.AI.
Relacionado
Configuração completa do provedor Z.AI e endpoints regionais.
Escolha de provedores, refs de modelo e comportamento de failover.
Níveis de /think para a família GLM com suporte a raciocínio.
Perfis de autenticação, troca de modelos e resolução de erros de "sem perfil".