Z.AI

IDs glm-5* desconhecidos ainda são resolvidos prospectivamente no caminho do provedor ao sintetizar metadados de propriedade do 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 raciocínio da Z.AI segue os controles /think do OpenClaw. Com o raciocínio desativado, o 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 raciocínio preservado é opcional porque a Z.AI exige que todo o histórico de reasoning_content seja reproduzido, o que aumenta os tokens do prompt. Habilite-o por modelo:

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

Quando habilitado e o raciocínio está ativo, o OpenClaw envia thinking: { type: "enabled", clear_thinking: false } e reproduz 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 da Z.AI registra compreensão de imagem.

A compreensão de imagem é resolvida automaticamente a partir da autenticação Z.AI configurada — 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 testando 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 superfície de API específica.
• A variável de ambiente legada Z_AI_API_KEY ainda é aceita; o OpenClaw a copia para ZAI_API_KEY na inicialização se ZAI_API_KEY não estiver definida.