Z.AI 是 GLM 模型系列的 API 平台,使用 Bearer 认证。OpenClaw 通过 zai provider 接入。

属性值
Provider IDzai
认证ZAI_API_KEY
APIZ.AI Chat Completions(Bearer auth)
默认模型zai/glm-5.1

快速开始

# 自动检测端点(推荐)
openclaw onboard --auth-choice zai-api-key
{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}

区域端点选项

onboarding 选项说明
zai-api-key自动检测匹配端点(推荐)
zai-coding-globalCoding Plan 全球端点
zai-coding-cnCoding Plan 中国区
zai-global通用 API 全球
zai-cn通用 API 中国区

内置模型目录

模型 ref说明
zai/glm-5.1默认模型
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

高级配置

工具调用流式传输(默认启用,可关闭):

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

Thinking 保留(opt-in,会增加 prompt token):

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

图像理解:自动从已配置的 Z.AI 认证解析,使用 glm-4.6v 模型,无需额外配置。

相关链接