openclaw/docs/providers/zai.md

summary, read_when, title

summary	read_when	title
Use Z.AI (GLM models) with OpenClaw	You want Z.AI / GLM models in OpenClaw You need a simple ZAI_API_KEY setup	Z.AI

Z.AI

Z.AI is the API platform for GLM models. It provides REST APIs for GLM and uses API keys for authentication. Create your API key in the Z.AI console. OpenClaw uses the zai provider with a Z.AI API key.

CLI setup

# Generic API-key setup with endpoint auto-detection
openclaw onboard --auth-choice zai-api-key

# Coding Plan Global, recommended for Coding Plan users
openclaw onboard --auth-choice zai-coding-global

# Coding Plan CN (China region), recommended for Coding Plan users
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

Config snippet

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

zai-api-key lets OpenClaw detect the matching Z.AI endpoint from the key and apply the correct base URL automatically. Use the explicit regional choices when you want to force a specific Coding Plan or general API surface.

Bundled GLM catalog

OpenClaw currently seeds the bundled zai provider with:

• 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

Notes

• GLM models are available as zai/<model> (example: zai/glm-5).
• Default bundled model ref: zai/glm-5
• tool_stream is enabled by default for Z.AI tool-call streaming. Set agents.defaults.models["zai/<model>"].params.tool_stream to false to disable it.
• See /providers/glm for the model family overview.
• Z.AI uses Bearer auth with your API key.