提供商

GLM(智谱)

GLM 是可通过 Z.AI 平台使用的模型系列(不是公司)。在 OpenClaw 中,GLM 模型通过内置的 zai 提供商访问,引用格式如 zai/glm-5.1

属性
提供商 ID zai
插件 内置,enabledByDefault: true
认证环境变量 ZAI_API_KEYZ_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-turboglm-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 提供商页面

    相关