Z.AI

Z.AI 是 GLM 模型的 API 平台。它为 GLM 提供 REST API，并使用 API 密钥进行身份验证。请在 Z.AI 控制台 中创建您的 API 密钥。 OpenClaw 使用 zai 提供商和 Z.AI API 密钥。

GLM 模型¶

GLM 是一个模型系列，而不是独立的提供商。在 OpenClaw 中，GLM 模型使用 诸如 zai/glm-5.3 的引用：提供商 zai，模型 ID glm-5.3。

快速开始¶

首先安装提供商插件：

openclaw plugins install @openclaw/zai-provider

**适用于：** 大多数用户。OpenClaw 会使用您的 API 密钥探测受支持的 Z.AI 端点，并自动应用正确的 base URL。

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

openclaw models list --all --provider zai

**适用于：** 希望强制使用特定 Coding Plan 或通用 API 接口的用户。

# Coding Plan Global (recommended for Coding Plan users)
openclaw onboard --auth-choice zai-coding-global

# Coding Plan CN (China region)
openclaw onboard --auth-choice zai-coding-cn

# General API
openclaw onboard --auth-choice zai-global

# General API CN (China region)
openclaw onboard --auth-choice zai-cn

openclaw models list --all --provider zai

端点¶

Z.AI 还发布了兼容 Anthropic 的 Coding Plan base URL https://api.z.ai/api/anthropic。OpenClaw 的 Z.AI 选项使用上述文档中记录的 OpenAI Chat Completions 端点；Anthropic URL 适用于直接调用 Anthropic Messages 的客户端。

zai-api-key 会自动检测这四个端点之一：它会使用您的密钥探测每个 端点的 chat-completions API，先检查通用端点（zai-global， 然后 zai-cn），再检查 Coding Plan 端点（zai-coding-global，然后 zai-coding-cn），并在第一个接受请求的端点处停止。 如果您的密钥在两者上都能使用，请使用显式的 --auth-choice 强制使用 Coding Plan 端点。

速率限制与过载¶

Z.AI 将 Coding Plan 和通用智能体工具记录为容量 管理服务。在 Z.AI 自己的文档中：

• 通用智能体工具, 包括 OpenClaw，按尽力而为的方式提供服务。在高推理 负载期间，通常在新加坡时间下午 2 点至 6 点左右，部分请求可能会遇到临时 速率限制。
• Coding Plan 速率和并发限制 与套餐层级绑定，并可根据资源 可用性动态调整。非高峰时段可能具有更高的并发。
• API 错误代码 1302 表示“请求 已达到速率限制”。API 错误代码 1305 表示“服务可能 暂时过载，请稍后重试”。

如果在繁忙时段看到临时的 429 或 1305 响应，请等待 并重试请求。如果失败在高峰时段之外可重复出现，或仅 发生在某个端点、模型或请求格式上，请先检查已配置的端点 和模型：

openclaw models list --all --provider zai
openclaw config get models.providers.zai.baseUrl

Coding Plan 密钥应使用 Coding Plan 端点，例如 https://api.z.ai/api/coding/paas/v4；通用 API 密钥应使用通用 API 端点，例如 https://api.z.ai/api/paas/v4。同一密钥和端点持续失败可能表示提供商端拒绝或套餐限制， 而不是普通的高峰负载节流。

配置示例¶

{
  env: { vars: { ZAI_API_KEY: "sk-..." } },
  models: {
    providers: {
      zai: {
        // GLM-5.3 uses the Coding Plan endpoint.
        baseUrl: "https://api.z.ai/api/coding/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.3" } } },
}

内置目录¶

zai 提供商插件将其目录打包在插件清单中，因此只读 列表可以在不加载提供商运行时的情况下显示已知的 GLM 条目：

openclaw models list --all --provider zai

由清单支持的目录包括：

按量付费目录条目遵循 Z.AI 当前的 API 定价。GLM-5.3 Flash 使用其按量付费的标价，即使存在临时折扣也是如此。GLM-5.3 目前是 Coding Plan 模型，因此其本地目录成本为零；Coding Plan 订阅使用计划配额而非按 Token 计费。有关计划定价和可用性，请参阅最新订阅页面。

视频生成¶

同一插件和 ZAI_API_KEY（或 Z_AI_API_KEY）支持 视频生成工具 使用 zai/cogvideox-3。它接受文本提示词或一张 PNG/JPEG 图片，包括以数据 URI（最大 5 MB）发送的本地文件。不支持视频引用。

时长会被标准化为 5 秒或 10 秒。尺寸和宽高比提示会映射到最接近的支持尺寸：1280x720、720x1280、1024x1024、1920x1080、1080x1920、2048x1080 或 3840x2160。输出默认为无音频的 720P 横向画面；audio: true 可启用声音。可使用 providerOptions.quality（speed 或 quality）和 providerOptions.fps（30 或 60）进行进一步控制。

视频使用所配置的全球或中国区域的通用 /api/paas/v4 端点。Coding Plan 聊天端点会映射到同一区域的通用视频端点；视频需要该端点具备 API 访问权限和计费。

{
  agents: {
    defaults: {
      mediaModels: {
        video: { primary: "zai/cogvideox-3" },
      },
    },
  },
}

思考级别¶

将思考设置为 off 可避免响应在可见文本之前将输出预算消耗在 reasoning_content 上。

高级配置¶

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

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

相关¶

模型选择

选择 provider、模型引用和故障转移行为。

配置参考

完整的 OpenClaw 配置 schema，包括 provider 和模型设置。