Z.AI

Z.AI 是 GLM 模型的 API 平台。它为 GLM 提供 REST API，并使用 API key 进行身份验证。请在 Z.AI 控制台中创建 API key。 OpenClaw 将 Z.AI API key 与 zai 提供商配合使用。

GLM 模型

GLM 是一个模型系列，而非独立的提供商。在 OpenClaw 中，GLM 模型使用 zai/glm-5.2 之类的引用：提供商为 zai，模型 ID 为 glm-5.2。

入门指南

请先安装提供商插件：

openclaw plugins install @openclaw/zai-provider

openclaw onboard --auth-choice zai-api-key

openclaw models list --all --provider zai

# Coding Plan 全球端点（建议 Coding Plan 用户使用）openclaw onboard --auth-choice zai-coding-global # Coding Plan 中国区端点openclaw onboard --auth-choice zai-coding-cn # 通用 APIopenclaw onboard --auth-choice zai-global # 通用 API 中国区端点openclaw onboard --auth-choice zai-cn

openclaw models list --all --provider zai

端点

Z.AI 还发布了与 Anthropic 兼容的 Coding Plan 基础 URL： https://api.z.ai/api/anthropic。OpenClaw 的 Z.AI 选项使用上面列出的 OpenAI Chat Completions 端点；Anthropic URL 适用于直接使用 Anthropic Messages 协议的客户端。

zai-api-key 会通过使用你的 key 逐一探测这四个端点的 Chat Completions API 来自动检测其中之一。它会先检查通用端点（zai-global， 然后是 zai-cn），再检查 Coding Plan 端点（zai-coding-global，然后是 zai-coding-cn），并在找到第一个接受请求的端点时停止。如果你的 key 在两类端点上都能使用，请使用显式的 --auth-choice 强制指定 Coding Plan 端点。

速率限制和过载

Z.AI 文档将 Coding Plan 和通用智能体工具描述为实行容量管理的服务。根据 Z.AI 自己的文档：

• 通用智能体工具 （包括 OpenClaw）以尽力而为的方式提供服务。在推理负载较高期间（通常为新加坡时间下午 2 点至 6 点）， 某些请求可能会受到临时速率限制。
• Coding Plan 速率和并发限制 与套餐等级相关，并可根据资源可用性动态调整。非高峰时段的并发量可能更高。
• API 错误代码 1302 表示“请求已达到 速率限制”。API 错误代码 1305 表示“服务可能暂时过载，请稍后重试”。

如果在繁忙时段看到临时的 429 或 1305 响应，请等待后重试请求。 如果故障在非高峰时段仍可重复出现，或仅发生在某个端点、模型或请求结构上， 请先检查所配置的端点和模型：

openclaw models list --all --provider zaiopenclaw config get models.providers.zai.baseUrl

Coding Plan key 应使用 https://api.z.ai/api/coding/paas/v4 等 Coding Plan 端点； 通用 API key 应使用 https://api.z.ai/api/paas/v4 等通用 API 端点。相同 key 和端点持续发生故障，可能表明请求被提供商拒绝或受到套餐限制， 而非普通的高峰负载限流。

配置示例

{  env: { ZAI_API_KEY: "sk-..." },  models: {    providers: {      zai: {        // GLM-5.2 使用 Coding Plan 端点。        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

基于清单的目录当前包括：

目录中的 token 成本元数据遵循 Z.AI 当前的 按量付费定价。Coding Plan 订阅使用套餐配额，而非按 token 计费；有关套餐定价和可用性，请参阅实时 订阅页面。

思考级别

将思考级别设置为 off，可避免响应在显示可见文本之前将输出预算消耗在 reasoning_content 上。

高级配置

{  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}

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

相关内容