Providers

Z.AI

Z.AI é a plataforma de API para os modelos GLM. Ela fornece APIs REST para o GLM e usa chaves de API para autenticação. Crie sua chave de API no console da Z.AI. O OpenClaw usa o provedor zai com uma chave de API da Z.AI.

Propriedade	Valor
Provedor	`zai`
Pacote	`@openclaw/zai-provider`
Autenticação	`ZAI_API_KEY` (alias legado: `Z_AI_API_KEY`)
API	Chat Completions da Z.AI (autenticação Bearer)

Modelos GLM

GLM é uma família de modelos, não um provedor separado. No OpenClaw, os modelos GLM usam referências como zai/glm-5.2: provedor zai, ID do modelo glm-5.2.

Primeiros passos

Primeiro, instale o Plugin do provedor:

bash

openclaw plugins install @openclaw/zai-provider

Detecção automática do endpoint

Mais indicado para: a maioria dos usuários. O OpenClaw testa os endpoints compatíveis da Z.AI com sua chave de API e aplica automaticamente a URL base correta.

Executar a configuração inicial

bash

openclaw onboard --auth-choice zai-api-key

Verificar se o modelo está listado

bash

openclaw models list --all --provider zai

Endpoint regional explícito

Mais indicado para: usuários que desejam forçar um Coding Plan específico ou a API geral.

Escolher a opção correta de configuração inicial

bash

# Coding Plan Global (recomendado para usuários do Coding Plan)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (região da China)openclaw onboard --auth-choice zai-coding-cn # API geralopenclaw onboard --auth-choice zai-global # API geral CN (região da China)openclaw onboard --auth-choice zai-cn

Verificar se o modelo está listado

bash

openclaw models list --all --provider zai

Endpoints

Opção de configuração inicial	URL base	Modelo padrão
`zai-global`	`https://api.z.ai/api/paas/v4`	`glm-5.1`
`zai-cn`	`https://open.bigmodel.cn/api/paas/v4`	`glm-5.1`
`zai-coding-global`	`https://api.z.ai/api/coding/paas/v4`	`glm-5.2`
`zai-coding-cn`	`https://open.bigmodel.cn/api/coding/paas/v4`	`glm-5.2`

zai-api-key detecta automaticamente um desses quatro endpoints testando sua chave na API de chat completions de cada endpoint, verificando primeiro os endpoints gerais (zai-global, depois zai-cn) e, em seguida, os endpoints do Coding Plan (zai-coding-global, depois zai-coding-cn), e parando no primeiro endpoint que aceitar uma solicitação. Use uma opção --auth-choice explícita para forçar um endpoint do Coding Plan caso sua chave funcione em ambos.

Exemplo de configuração

json5

{  env: { ZAI_API_KEY: "sk-..." },  models: {    providers: {      zai: {        // GLM-5.2 usa o endpoint do Coding Plan.        baseUrl: "https://api.z.ai/api/coding/paas/v4",      },    },  },  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },}

Catálogo integrado

O Plugin do provedor zai inclui seu catálogo no manifesto do Plugin, portanto a listagem somente leitura pode exibir as entradas conhecidas do GLM sem carregar o runtime do provedor:

bash

openclaw models list --all --provider zai

Atualmente, o catálogo baseado no manifesto inclui:

Referência do modelo	Observações
`zai/glm-5.2`	Padrão do Coding Plan; contexto de 1 milhão
`zai/glm-5.1`	Padrão da API geral
`zai/glm-5`
`zai/glm-5-turbo`
`zai/glm-5v-turbo`
`zai/glm-4.7`
`zai/glm-4.7-flash`
`zai/glm-4.7-flashx`
`zai/glm-4.6`
`zai/glm-4.6v`
`zai/glm-4.5`
`zai/glm-4.5-air`
`zai/glm-4.5-flash`
`zai/glm-4.5v`

Níveis de raciocínio

GLM-5.2

Faixa completa: off, low, high, max (padrão: off). O OpenClaw mapeia low e high para o esforço de raciocínio high da Z.AI e max para o esforço max da Z.AI, por meio de reasoning_effort no payload da solicitação.

Outros modelos GLM

Apenas alternância binária: off e low (exibido como on nos seletores), com padrão off. Definir o raciocínio como off envia thinking: { type: "disabled" }; qualquer outro nível deixa o payload da solicitação inalterado (aplica-se o comportamento de raciocínio padrão da Z.AI).

Definir o raciocínio como off evita respostas que consumam o orçamento de saída com reasoning_content antes do texto visível.

Configuração avançada

Resolução futura de modelos GLM-5 desconhecidos

IDs glm-5* desconhecidos ainda são resolvidos dinamicamente no caminho do provedor por meio da sintetização de metadados pertencentes ao provedor a partir do modelo glm-4.7, quando o ID corresponde ao formato atual da família GLM-5.

Streaming de chamadas de ferramentas

tool_stream fica habilitado por padrão para o streaming de chamadas de ferramentas da Z.AI. Para desabilitá-lo:

json5

{  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}

Raciocínio preservado

O raciocínio preservado é opcional porque a Z.AI exige que todo o reasoning_content histórico seja reproduzido, o que aumenta a quantidade de tokens do prompt. Habilite-o por modelo:

json5

{  agents: {    defaults: {      models: {        "zai/glm-5.2": {          params: { preserveThinking: true },        },      },    },  },}

Quando habilitado e com o raciocínio ativado, o OpenClaw envia thinking: { type: "enabled", clear_thinking: false } e reproduz o reasoning_content anterior para a mesma transcrição compatível com a OpenAI. A chave de parâmetro em snake_case preserve_thinking funciona como alias.

Usuários avançados ainda podem substituir o payload exato do provedor por meio de params.extra_body.thinking.

Compreensão de imagens

O Plugin da Z.AI registra a compreensão de imagens.

Propriedade	Valor
Modelo	`glm-4.6v`

A compreensão de imagens é resolvida automaticamente a partir da autenticação configurada da Z.AI — nenhuma configuração adicional é necessária.

Detalhes da autenticação

A Z.AI usa autenticação Bearer com sua chave de API.
A opção de configuração inicial zai-api-key detecta automaticamente o endpoint correspondente da Z.AI, testando os endpoints compatíveis com sua chave.
Use as opções regionais explícitas (zai-coding-global, zai-coding-cn, zai-global, zai-cn) quando quiser forçar uma API específica.
A variável de ambiente legada Z_AI_API_KEY ainda é aceita; o OpenClaw a copia para ZAI_API_KEY durante a inicialização se ZAI_API_KEY não estiver definida.

Relacionado

Seleção de modelos

Como escolher provedores, referências de modelos e o comportamento de failover.

Referência de configuração

Esquema completo de configuração do OpenClaw, incluindo as configurações de provedores e modelos.

Was this useful?

Z.AI

Modelos GLM

Primeiros passos

Detecção automática do endpoint

Executar a configuração inicial

Verificar se o modelo está listado

Endpoint regional explícito

Escolher a opção correta de configuração inicial

Verificar se o modelo está listado

Endpoints

Exemplo de configuração

Catálogo integrado

Níveis de raciocínio

GLM-5.2

Outros modelos GLM

Configuração avançada

Relacionado

On this page

Molty