提供商
Z.AI
Z.AI 是 GLM 模型的 API 平台。它为 GLM 提供 REST API，并使用 API key 进行身份验证。请在 Z.AI 控制台中创建你的 API key。
OpenClaw 通过 zai 提供商使用 Z.AI API key。
| 属性 | 值 |
|---|---|
| 提供商 | zai |
| 软件包 | @openclaw/zai-provider |
| 身份验证 | ZAI_API_KEY（旧版别名：Z_AI_API_KEY） |
| API | Z.AI Chat Completions（Bearer 身份验证） |
GLM 模型
GLM 是一个模型系列，而不是独立的提供商。在 OpenClaw 中，GLM 模型使用
zai/glm-5.2 之类的引用：提供商为 zai，模型 ID 为 glm-5.2。
入门指南
首先安装提供商插件：
openclaw plugins install @openclaw/zai-provider自动检测端点
**最适合：**大多数用户。OpenClaw 会使用你的 API key 探测受支持的 Z.AI 端点，并自动应用正确的基础 URL。
运行新手引导
openclaw onboard --auth-choice zai-api-key验证模型已列出
openclaw models list --all --provider zai明确指定区域端点
**最适合：**希望强制使用特定 Coding Plan 或通用 API 接口的用户。
选择正确的新手引导选项
# 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 APIopenclaw onboard --auth-choice zai-global # General API CN (China region)openclaw onboard --auth-choice zai-cn验证模型已列出
openclaw models list --all --provider zai端点
| 新手引导选项 | 基础 URL | 默认模型 |
|---|---|---|
zai-global |
https://api.z.ai/api/paas/v4 |
glm-5.1 |
zai-cn |
https://open.bigmodel.cn/api/paas/v4 |
glm-5.1 |
zai-coding-global |
https://api.z.ai/api/coding/paas/v4 |
glm-5.2 |
zai-coding-cn |
https://open.bigmodel.cn/api/coding/paas/v4 |
glm-5.2 |
zai-api-key 会通过针对每个端点的 chat-completions API 探测你的密钥，自动检测这四个端点之一。它会先检查通用端点（zai-global，
然后是 zai-cn），再检查 Coding Plan 端点（zai-coding-global，然后是
zai-coding-cn），并在第一个接受请求的端点处停止。如果你的密钥在两类端点上都能使用，请通过明确指定 --auth-choice 来强制使用 Coding Plan 端点。
配置示例
{ env: { ZAI_API_KEY: "sk-..." }, models: { providers: { zai: { // GLM-5.2 uses the Coding Plan endpoint. baseUrl: "https://api.z.ai/api/coding/paas/v4", }, }, }, agents: { defaults: { model: { primary: "zai/glm-5.2" } } },}内置目录
zai 提供商插件在插件清单中随附其目录，因此只读列表无需加载提供商运行时，即可显示已知的 GLM 条目：
openclaw models list --all --provider zai清单支持的目录目前包括：
| 模型引用 | 备注 |
|---|---|
zai/glm-5.2 |
Coding Plan 默认模型；1M 上下文 |
zai/glm-5.1 |
通用 API 默认模型 |
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 |
思考级别
GLM-5.2
完整范围：off、low、high、max（默认为 off）。OpenClaw 通过请求负载中的 reasoning_effort，
将 low 和 high 映射到 Z.AI 的 high 推理强度，并将 max 映射到 Z.AI 的
max 强度。
其他 GLM 模型
仅支持二元切换：off 和 low（在选择器中显示为 on），默认为
off。将思考设置为 off 会发送 thinking: { type: "disabled" }；
任何其他级别都不会修改请求负载（将应用 Z.AI 自身的默认推理行为）。
将思考设置为 off 可避免响应在显示可见文本之前，将输出预算消耗在
reasoning_content 上。
高级配置
前向解析未知的 GLM-5 模型
当 ID 符合当前 GLM-5 系列的格式时，未知的 glm-5* ID 仍会在提供商路径上进行前向解析，方法是根据 glm-4.7 模板合成由提供商所有的元数据。
工具调用流式传输
Z.AI 工具调用流式传输默认启用 tool_stream。若要将其禁用：
{ agents: { defaults: { models: { "zai/<model>": { params: { tool_stream: false }, }, }, }, },}保留思考内容
保留思考内容是可选功能，因为 Z.AI 要求重放完整的历史
reasoning_content，这会增加提示词 token 数量。可按模型启用：
{ agents: { defaults: { models: { "zai/glm-5.2": { params: { preserveThinking: true }, }, }, }, },}启用并开启思考后，OpenClaw 会发送
thinking: { type: "enabled", clear_thinking: false }，并为同一份 OpenAI 兼容对话记录重放之前的
reasoning_content。蛇形命名的 preserve_thinking 参数键也可用作别名。
高级用户仍可通过 params.extra_body.thinking 覆盖确切的提供商负载。
图像理解
Z.AI 插件会注册图像理解功能。
| 属性 | 值 |
|---|---|
| 模型 | glm-4.6v |
图像理解会根据已配置的 Z.AI 身份验证信息自动解析，无需额外配置。
身份验证详情
- Z.AI 使用你的 API key 进行 Bearer 身份验证。
zai-api-key新手引导选项会使用你的密钥探测受支持的端点，从而自动检测匹配的 Z.AI 端点。- 如果你希望强制使用特定 API 接口，请使用明确的区域选项（
zai-coding-global、zai-coding-cn、zai-global、zai-cn）。 - 旧版环境变量
Z_AI_API_KEY仍然受支持；如果未设置ZAI_API_KEY，OpenClaw 会在启动时将其复制到ZAI_API_KEY。
