跳转到主要内容
Z.AI 是 GLM 模型的 API 平台。它为 GLM 提供 REST API，并使用 API key 进行身份验证。请在 Z.AI 控制台中创建你的 API key。OpenClaw 使用带有 Z.AI API key 的 zai 提供商。
属性值
提供商zai
包@openclaw/zai-provider
凭证ZAI_API_KEY（旧版别名：Z_AI_API_KEY）
APIZ.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 端点，并自动应用正确的 base URL。
1

运行新手引导

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

验证模型已列出

openclaw models list --all --provider zai

​
端点

新手引导选项Base URL默认模型
zai-globalhttps://api.z.ai/api/paas/v4glm-5.1
zai-cnhttps://open.bigmodel.cn/api/paas/v4glm-5.1
zai-coding-globalhttps://api.z.ai/api/coding/paas/v4glm-5.2
zai-coding-cnhttps://open.bigmodel.cn/api/coding/paas/v4glm-5.2
zai-api-key 会通过用你的 key 探测每个端点的 chat-completions API，在这四个端点中自动检测一个；它会先检查通用端点（zai-global，然后是 zai-cn），再检查 Coding Plan 端点（zai-coding-global，然后是 zai-coding-cn），并在第一个接受请求的端点处停止。如果你的 key 在两者上都可用，请使用显式 --auth-choice 来强制使用 Coding Plan 端点。

​
配置示例

zai-api-key 让 OpenClaw 根据 key 检测匹配的 Z.AI 端点，并自动应用正确的 base URL。当你想强制使用特定 Coding Plan 或通用 API 表面时，请使用显式区域选项。
{
  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.2Coding 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 模型可作为 zai/<model> 使用（示例：zai/glm-5）。
Coding Plan 设置默认使用 zai/glm-5.2；通用 API 设置保留 zai/glm-5.1。在 Coding Plan 端点上，当 key/计划未暴露 GLM-5.2 时，自动检测会回退到 glm-5.1，然后回退到 glm-4.7。GLM 版本和可用性可能会变化；运行 openclaw models list --all --provider zai 查看你的已安装版本已知的目录。

​
思考级别

完整范围：off、low、high、max（默认 off）。OpenClaw 通过请求载荷中的 reasoning_effort，将 low 和 high 映射到 Z.AI 的 high 推理强度，并将 max 映射到 Z.AI 的 max 强度。
将思考设置为 off 可避免响应在可见文本之前将输出预算花在 reasoning_content 上。

​
高级配置

未知的 glm-5* ID 仍会在提供商路径上向前解析：当 ID 匹配当前 GLM-5 系列形态时，会从 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。snake_case 的 preserve_thinking 参数键可作为别名使用。高级用户仍可使用 params.extra_body.thinking 覆盖确切的提供商载荷。
Z.AI 插件注册了图像理解。
属性值
模型glm-4.6v
图像理解会根据配置的 Z.AI 凭证自动解析，无需额外配置。
  • Z.AI 使用带有你的 API key 的 Bearer 认证。
  • zai-api-key 新手引导选项会通过用你的 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。

​
相关内容

模型选择

选择提供商、模型引用和故障转移行为。

配置参考

完整的 OpenClaw 配置 schema，包括提供商和模型设置。