Pular para o conteúdo principal

​
Z.AI

A Z.AI é a plataforma de API para modelos GLM. Ela fornece APIs REST para 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.
  • Provedor: zai
  • Autenticação: ZAI_API_KEY
  • API: Z.AI Chat Completions (autenticação Bearer)

​
Primeiros passos

Ideal para: a maioria dos usuários. O OpenClaw detecta o endpoint Z.AI correspondente a partir da chave e aplica automaticamente a URL base correta.
1

Execute o onboarding

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

Defina um modelo padrão

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
3

Verifique se o modelo está disponível

openclaw models list --provider zai

​
Catálogo GLM agrupado

Atualmente, o OpenClaw inicializa o provedor agrupado zai com:
Ref. do modeloObservações
zai/glm-5.1Modelo padrão
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
Os modelos GLM estão disponíveis como zai/<model> (exemplo: zai/glm-5). A ref de modelo agrupada padrão é zai/glm-5.1.

​
Configuração avançada

IDs desconhecidos glm-5* ainda são resolvidos futuramente no caminho do provedor agrupado 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.
tool_stream é ativado por padrão para streaming de chamadas de ferramenta da Z.AI. Para desativá-lo:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
O plugin agrupado da Z.AI registra entendimento de imagem.
PropriedadeValor
Modeloglm-4.6v
O entendimento de imagem é resolvido automaticamente a partir da autenticação configurada da Z.AI — nenhuma configuração adicional é necessária.
  • A Z.AI usa autenticação Bearer com sua chave de API.
  • A opção de onboarding zai-api-key detecta automaticamente o endpoint Z.AI correspondente a partir do prefixo da chave.
  • Use as opções regionais explícitas (zai-coding-global, zai-coding-cn, zai-global, zai-cn) quando quiser forçar uma superfície específica de API.

​
Relacionados

Família de modelos GLM

Visão geral da família de modelos GLM.

Seleção de modelo

Escolha de provedores, refs de modelo e comportamento de failover.