Providers
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 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
Detectar endpoint automaticamente
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.
Execute o onboarding
openclaw onboard --auth-choice zai-api-key
Defina um modelo padrão
{
env: { ZAI_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
Verifique se o modelo está listado
openclaw models list --all --provider zai
Endpoint regional explícito
Ideal para: usuários que desejam forçar um Coding Plan específico ou uma superfície geral de API.
Escolha a opção de onboarding correta
# Coding Plan Global (recommended for Coding Plan users)
openclaw onboard --auth-choice zai-coding-global
# Coding Plan CN (China region)
openclaw onboard --auth-choice zai-coding-cn
# General API
openclaw onboard --auth-choice zai-global
# General API CN (China region)
openclaw onboard --auth-choice zai-cn
Defina um modelo padrão
{
env: { ZAI_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
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 modelo | Observações |
|---|---|
zai/glm-5.1 |
Modelo 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 |
Configuração avançada
Resolução futura de modelos GLM-5 desconhecidos
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.
Streaming de chamadas de ferramenta
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 },
},
},
},
},
}
Thinking e thinking preservado
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.
Compreensão de imagens
O Plugin Z.AI empacotado registra compreensão de imagens.
| Propriedade | Valor |
|---|---|
| Modelo | glm-4.6v |
A compreensão de imagens é resolvida automaticamente a partir da autenticação Z.AI configurada, sem necessidade de configuração adicional.
Detalhes de autenticação
- Z.AI usa autenticação Bearer com sua chave de API.
- A opção de onboarding
zai-api-keydetecta 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.