提供商
GLM(智谱)
GLM 是可通过 Z.AI 平台使用的模型系列(不是公司)。在 OpenClaw 中,GLM 模型通过内置的 zai 提供商访问,引用格式如 zai/glm-5.1。
| 属性 | 值 |
|---|---|
| 提供商 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 套餐和区域匹配的新手引导选项。通用的 zai-api-key 选项会根据密钥形态自动检测匹配的端点;如果你想强制使用特定的 Coding Plan 或通用 API 表面,请使用明确的区域选项。
| 认证选项 | 最适合 |
|---|---|
zai-api-key |
带端点自动检测的通用 API key |
zai-coding-global |
Coding Plan 用户(全球) |
zai-coding-cn |
Coding Plan 用户(中国区域) |
zai-global |
通用 API(全球) |
zai-cn |
通用 API(中国区域) |
openclaw onboard --auth-choice zai-api-key
openclaw onboard --auth-choice zai-coding-global
openclaw onboard --auth-choice zai-coding-cn
openclaw onboard --auth-choice zai-global
openclaw onboard --auth-choice zai-cn
将 GLM 设置为默认模型
openclaw config set agents.defaults.model.primary "zai/glm-5.1"
验证模型可用
openclaw models list --provider zai
配置示例
{
env: { ZAI_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
内置目录
内置的 zai 提供商会预置 13 个 GLM 模型引用。除非另有标注,所有条目都支持推理;glm-5v-turbo 和 glm-4.6v 除文本外也接受图像输入。
| 模型引用 | 说明 |
|---|---|
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 |
推理,文本 + 图像。 |
高级配置
端点自动检测
使用 zai-api-key 认证选项时,OpenClaw 会检查密钥形态以确定正确的 Z.AI base URL。明确的区域选项(zai-coding-global, zai-coding-cn, zai-global, zai-cn)会覆盖自动检测并直接固定端点。
提供商详情
GLM 模型由 zai 运行时提供商提供服务。有关完整的提供商配置、区域端点和其他能力,请参阅 Z.AI 提供商页面。