Pular para o conteúdo principal

Z.AI

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 do Z.AI. O OpenClaw usa o provedor zai com uma chave de API do Z.AI.

Setup na CLI

# Setup genérico com chave de API e autodetecção de endpoint
openclaw onboard --auth-choice zai-api-key

# Coding Plan Global, recomendado para usuários do Coding Plan
openclaw onboard --auth-choice zai-coding-global

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

# API geral
openclaw onboard --auth-choice zai-global

# API geral CN (região da China)
openclaw onboard --auth-choice zai-cn

Trecho de configuração

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5" } } },
}
zai-api-key permite que o OpenClaw detecte o endpoint Z.AI correspondente a partir da chave e aplique automaticamente a base URL correta. Use as opções regionais explícitas quando quiser forçar uma superfície específica do Coding Plan ou da API geral.

Catálogo GLM integrado

Atualmente, o OpenClaw inicializa o provedor integrado zai com:
  • glm-5.1
  • glm-5
  • glm-5-turbo
  • glm-5v-turbo
  • glm-4.7
  • glm-4.7-flash
  • glm-4.7-flashx
  • glm-4.6
  • glm-4.6v
  • glm-4.5
  • glm-4.5-air
  • glm-4.5-flash
  • glm-4.5v

Observações

  • Os modelos GLM estão disponíveis como zai/<model> (exemplo: zai/glm-5).
  • Referência de modelo padrão integrada: zai/glm-5
  • IDs desconhecidos glm-5* ainda são resolvidos de forma antecipada no caminho do provedor integrado sintetizando metadados pertencentes ao provedor a partir do template glm-4.7 quando o id corresponde ao formato atual da família GLM-5.
  • tool_stream vem habilitado por padrão para streaming de chamadas de ferramenta do Z.AI. Defina agents.defaults.models["zai/<model>"].params.tool_stream como false para desativá-lo.
  • Veja /providers/glm para a visão geral da família de modelos.
  • O Z.AI usa autenticação Bearer com sua chave de API.