mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-06 14:51:08 +00:00
73 lines
1.8 KiB
Markdown
73 lines
1.8 KiB
Markdown
---
|
|
summary: "Use Z.AI (GLM models) with OpenClaw"
|
|
read_when:
|
|
- You want Z.AI / GLM models in OpenClaw
|
|
- You need a simple ZAI_API_KEY setup
|
|
title: "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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```json5
|
|
{
|
|
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](/providers/glm) for the model family overview.
|
|
- Z.AI uses Bearer auth with your API key.
|