GLM / Z.AI（智谱 AI）

智谱 AI 的 GLM 模型族通过 Z.AI 平台接入 OpenClaw。provider id 是 zai，模型 ref 格式为 zai/glm-5.1。

认证

ZAI_API_KEY 或 Z_AI_API_KEY

5 种 auth choice：

Auth Choice	说明
zai-api-key	自动检测区域
zai-coding-global	国际 Coding Plan
zai-coding-cn	国内 Coding Plan
zai-global	国际标准 API key
zai-cn	国内标准 API key

内置模型

模型 ref	说明
zai/glm-5.1	默认模型
zai/glm-5	标准版
zai/glm-5-turbo	快速版
zai/glm-5v-turbo	视觉快速版
zai/glm-4.7	上一代旗舰
zai/glm-4.6	上一代标准
zai/glm-4.5	上一代轻量

快速配置

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

{
  env: { ZAI_API_KEY: "your-key" },
  agents: {
    defaults: {
      model: { primary: "zai/glm-5.1" },
    },
  },
}

注意事项

• provider id 是 zai，不是 glm 或 zhipu
• zai-api-key 会自动检测国内/国际区域
• Coding Plan 与标准 API key 端点不同，不可混用

相关链接

• model-providers — provider 规则与 model ref 格式
• docs/gateway/configuration-reference — 完整配置参考