Appearance
通过 OpenClaw 的 zai provider 即可接入 GLM 模型系列（如 glm-5.1、glm-4.6v）。配置时需先设置 ZAI_API_KEY 环境变量，运行 openclaw onboard 选择认证方案（自动检测端点或指定区域），再设置默认模型。内置 13 个 GLM 模型引用，均支持推理，部分支持图片输入。若 openclaw models list --provider zai 无输出，请检查 API Key 和认证选项是否匹配。
GLM 模型接入 OpenClaw（Z.AI 平台）
GLM 是一组模型系列（非公司名），通过 Z.AI 平台提供。在 OpenClaw 中通过 zai provider 访问，模型引用格式为 zai/glm-5.1。
| 属性 | 值 |
|---|---|
| Provider id | zai |
| 插件类型 | 内置，enabledByDefault: true |
| 认证环境变量 | ZAI_API_KEY 或 Z_AI_API_KEY |
| 开通引导选项 | zai-api-key, zai-coding-global, zai-coding-cn, zai-global, zai-cn |
| API 兼容性 | OpenAI 兼容 |
| 默认 Base URL | https://api.z.ai/api/paas/v4 |
| 建议默认模型 | zai/glm-5.1 |
| 默认图片模型 | zai/glm-4.6v |
快速开始
选择认证方案并运行引导
根据你的 Z.AI 计划和区域选择对应的 `--auth-choice`。通用选项 `zai-api-key` 会根据 API Key 的格式自动检测端点；需要锁定 Coding Plan 或指定区域入口时使用明确的区域选项。
| 认证选项 | 适用场景 |
| ------------------- | -------------------------------------------------- |
| `zai-api-key` | 通用 API Key，自动检测端点 |
| `zai-coding-global` | Coding Plan 用户（全球） |
| `zai-coding-cn` | Coding Plan 用户（中国区域） |
| `zai-global` | 通用 API（全球） |
| `zai-cn` | 通用 API（中国区域） |
bash
openclaw onboard --auth-choice zai-api-keybash
openclaw onboard --auth-choice zai-coding-globalbash
openclaw onboard --auth-choice zai-coding-cnbash
openclaw onboard --auth-choice zai-globalbash
openclaw onboard --auth-choice zai-cn设置 GLM 为默认模型
```bash
openclaw config set agents.defaults.model.primary "zai/glm-5.1"
```
验证模型可用
```bash
openclaw models list --provider zai
```
配置示例
json5
{
env: { ZAI_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}TIP
zai-api-key 让 OpenClaw 根据 API Key 格式自动选择正确的 Z.AI 端点并应用 Base URL。当你需要锁定特定 Coding Plan 或通用 API 区域时，使用明确的区域选项覆盖自动检测。
内置模型列表
zai provider 预置了 13 个 GLM 模型引用。所有模型均支持推理（reasoning）；带 v 后缀的模型还支持图片输入。
| 模型引用 | 说明 |
|---|---|
zai/glm-5.1 | 默认模型。仅文本推理，上下文 202k。 |
zai/glm-5 | 仅文本推理，上下文 202k。 |
zai/glm-5-turbo | 仅文本推理，上下文 202k。 |
zai/glm-5v-turbo | 图片+文本推理，上下文 202k。 |
zai/glm-4.7 | 仅文本推理，上下文 204k。 |
zai/glm-4.7-flash | 仅文本推理，上下文 200k。 |
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 | 图片+文本推理。 |
::: note GLM 版本和可用性可能变化。运行 openclaw models list --provider zai 查看当前安装版本能识别的模型清单，并查阅 Z.AI 文档获取新添加或废弃的模型。 :::
高级配置
端点自动检测
使用 `zai-api-key` 认证选项时，OpenClaw 会检查 API Key 的格式来确定正确的 Z.AI Base URL。使用明确的区域选项（`zai-coding-global`、`zai-coding-cn`、`zai-global`、`zai-cn`）会覆盖自动检测并固定端点。
Provider 详情
GLM 模型由 `zai` 运行时 provider 提供服务。完整配置、区域端点及额外能力请参阅 [Z.AI provider](/ai/ai-tools/openclaw/providers/zai)。
相关链接
- Z.AI provider – 完整 Z.AI provider 配置和区域端点
- 模型提供者 – 选择提供者、模型引用和故障转移
- 思考模式 – 面向推理型 GLM 模型的
/think等级 - 模型 FAQ – 认证配置、切换模型和解决“无配置”错误
常见问题
为什么 openclaw models list --provider zai 看不到任何 GLM 模型
最常见原因是 ZAI_API_KEY 环境变量未设置或设置错误。先确认 Key 的合法性，然后运行 openclaw onboard --auth-choice zai-api-key 让引导程序自动检测端点。如果仍然为空，检查 Key 所属的 Z.AI 计划是否支持 GLM 系列。
如何将默认智能体模型切换为 glm-5.1
运行以下命令即可：
bash
openclaw config set agents.defaults.model.primary "zai/glm-5.1"之后新创建的对话将默认使用该模型。
应该选 zai-api-key 还是区域特定的认证选项
zai-api-key 会根据 Key 格式自动选择正确端点，适合多数场景。区域选项（如 zai-coding-cn）用于强制绑定某个区域入口或 Coding Plan，适用于需要固定访问路径的情况。如果在国内且使用 Coding Plan，可优先尝试 zai-coding-cn。