Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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. 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. OpenClaw detecta o endpoint Z.AI correspondente a partir da chave e aplica a URL base correta automaticamente.
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á listado

openclaw models list --all --provider zai

​
Catálogo integrado

OpenClaw inclui o catálogo do provedor zai empacotado no manifesto do Plugin, para que a listagem somente leitura possa mostrar linhas GLM conhecidas sem carregar o runtime do provedor: 
openclaw models list --all --provider zai
O catálogo baseado no manifesto atualmente inclui:
Referência 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 referência do modelo empacotado padrão é zai/glm-5.1.

​
Configuração avançada

IDs glm-5* desconhecidos ainda são resolvidos futuramente no caminho do provedor empacotado ao sintetizar 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 é habilitado por padrão para streaming de chamadas de ferramenta da Z.AI. Para desabilitá-lo:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
O thinking da Z.AI segue os controles /think do OpenClaw. Com thinking desativado, OpenClaw envia thinking: { type: "disabled" } para evitar respostas que gastem o orçamento de saída em reasoning_content antes do texto visível.O thinking preservado é opcional porque a Z.AI exige que todo o histórico de reasoning_content seja repetido, o que aumenta os tokens do prompt. Habilite-o por modelo:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Quando habilitado e o thinking está ativo, OpenClaw envia thinking: { type: "enabled", clear_thinking: false } e repete o reasoning_content anterior para a mesma transcrição compatível com OpenAI.Usuários avançados ainda podem substituir o payload exato do provedor com params.extra_body.thinking.
O Plugin Z.AI empacotado registra compreensão de imagens.
PropriedadeValor
Modeloglm-4.6v
A compreensão de imagens é resolvida automaticamente a partir da autenticação Z.AI configurada, sem necessidade de configuração adicional.
  • 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 de API específica.

​
Relacionado

Família de modelos GLM

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

Seleção de modelo

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