Z.AI

Z.AI 是 GLM 模型的 API 平台。它為 GLM 提供 REST API，並使用 API 金鑰進行驗證。請在 Z.AI 主控台中建立你的 API 金鑰。 OpenClaw 使用 zai 提供者搭配 Z.AI API 金鑰。

屬性	值
提供者	`zai`
套件	`@openclaw/zai-provider`
驗證	`ZAI_API_KEY`（舊版別名：`Z_AI_API_KEY`）
API	Z.AI Chat Completions（Bearer 驗證）

GLM 模型

GLM 是一個模型家族，而非獨立的提供者。在 OpenClaw 中，GLM 模型使用 zai/glm-5.2 之類的參照：提供者為 zai，模型 ID 為 glm-5.2。

開始使用

請先安裝提供者外掛：

openclaw plugins install @openclaw/zai-provider

自動偵測端點
明確指定區域端點

**最適合：**大多數使用者。OpenClaw 會使用你的 API 金鑰探測支援的 Z.AI 端點，並自動套用正確的基底 URL。

執行初始設定

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

確認模型已列出

openclaw models list --all --provider zai

**最適合：**想強制使用特定 Coding Plan 或一般 API 介面的使用者。

選擇正確的初始設定選項

# Coding Plan 全球端點（建議 Coding Plan 使用者使用）
openclaw onboard --auth-choice zai-coding-global

# Coding Plan 中國端點（中國地區）
openclaw onboard --auth-choice zai-coding-cn

# 一般 API
openclaw onboard --auth-choice zai-global

# 一般 API 中國端點（中國地區）
openclaw onboard --auth-choice zai-cn

確認模型已列出

openclaw models list --all --provider zai

端點

初始設定選項	基底 URL	預設模型
`zai-global`	`https://api.z.ai/api/paas/v4`	`glm-5.1`
`zai-cn`	`https://open.bigmodel.cn/api/paas/v4`	`glm-5.1`
`zai-coding-global`	`https://api.z.ai/api/coding/paas/v4`	`glm-5.2`
`zai-coding-cn`	`https://open.bigmodel.cn/api/coding/paas/v4`	`glm-5.2`

Z.AI 也發布了與 Anthropic 相容的 Coding Plan 基底 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。若同一組金鑰與端點持續失敗，可能表示提供者端拒絕請求或方案受到限制，而非一般的尖峰負載節流。

設定範例

zai-api-key 可讓 OpenClaw 從金鑰偵測相符的 Z.AI 端點，並自動套用正確的基底 URL。若你想強制使用特定 Coding Plan 或一般 API 介面，請使用明確指定區域的選項。

{
  env: { ZAI_API_KEY: "sk-..." },
  models: {
    providers: {
      zai: {
        // GLM-5.2 使用 Coding Plan 端點。
        baseUrl: "https://api.z.ai/api/coding/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },
}

內建目錄

zai 提供者外掛會將其目錄隨附於外掛資訊清單中，因此唯讀清單可在不載入提供者執行階段的情況下顯示已知的 GLM 列：

openclaw models list --all --provider zai

由資訊清單支援的目錄目前包含：

模型參照	備註
`zai/glm-5.2`	Coding Plan 預設值；1M 上下文
`zai/glm-5.1`	一般 API 預設值
`zai/glm-5`
`zai/glm-5-turbo`
`zai/glm-5v-turbo`
`zai/glm-4.7`
`zai/glm-4.7-flash`
`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`

目錄中的權杖成本中繼資料遵循 Z.AI 目前的隨用隨付定價。Coding Plan 訂閱使用方案配額，而非按權杖計費；方案定價與可用性請參閱即時訂閱頁面。

GLM 模型可透過 zai/<model> 使用（例如：zai/glm-5）。

Coding Plan 設定預設為 zai/glm-5.2；一般 API 設定則保留 zai/glm-5.1。在 Coding Plan 端點上，當金鑰／方案未提供 GLM-5.2 時，自動偵測會退回至 glm-5.1，接著再退回至 glm-4.7。GLM 版本與可用性可能變更；執行 openclaw models list --all --provider zai 以查看你所安裝版本已知的目錄。

思考層級

GLM-5.2
其他 GLM 模型

完整範圍：off、low、high、max（預設為 off）。OpenClaw 會透過請求酬載中的 reasoning_effort，將 low 與 high 對應至 Z.AI 的 high 推理強度，並將 max 對應至 Z.AI 的 max 強度。

僅支援二元切換：off 與 low（在選擇器中顯示為 on），預設為 off。將思考設為 off 會傳送 thinking: { type: "disabled" }；任何其他層級都不會變更請求酬載（套用 Z.AI 自身的預設推理行為）。

將思考設為 off，可避免回應在顯示可見文字前就將輸出預算耗費於 reasoning_content。

進階設定

向前解析未知的 GLM-5 模型

未知的 glm-5* ID 仍會在提供者路徑上向前解析：當 ID 符合目前 GLM-5 家族格式時，會從 glm-4.7 範本合成由提供者擁有的中繼資料。

工具呼叫串流

Z.AI 工具呼叫串流預設會啟用 tool_stream。若要停用：

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

保留思考內容

保留思考內容需選擇性啟用，因為 Z.AI 要求重播完整的歷史 reasoning_content，這會增加提示詞權杖。請為各模型分別啟用：

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

啟用且思考功能開啟時，OpenClaw 會傳送 thinking: { type: "enabled", clear_thinking: false }，並重播相同 OpenAI 相容逐字稿先前的 reasoning_content。蛇形命名的 preserve_thinking 參數鍵也可作為別名。進階使用者仍可使用 params.extra_body.thinking 覆寫確切的提供者酬載。

圖像理解

Z.AI 外掛會註冊圖像理解功能。

屬性	值
模型	`glm-4.6v`

圖像理解會從已設定的 Z.AI 驗證自動解析，不需要額外設定。

驗證詳細資訊

Z.AI 使用你的 API 金鑰進行 Bearer 驗證。
zai-api-key 初始設定選項會使用你的金鑰探測支援的端點，以自動偵測相符的 Z.AI 端點。
若你想強制使用特定 API 介面，請使用明確指定區域的選項（zai-coding-global、zai-coding-cn、zai-global、zai-cn）。
舊版環境變數 Z_AI_API_KEY 仍可使用；若未設定 ZAI_API_KEY，OpenClaw 會在啟動時將其複製至 ZAI_API_KEY。

模型選擇

選擇提供者、模型參照與容錯移轉行為。

設定參考

完整的 OpenClaw 設定結構描述，包括提供者與模型設定。

Overview

Concepts and configuration

Providers

GLM 模型

開始使用

端點

速率限制與超載

設定範例

內建目錄

思考層級

進階設定

相關內容

模型選擇

設定參考

​GLM 模型

​開始使用

​端點

​速率限制與超載

​設定範例

​內建目錄

​思考層級

​進階設定

​相關內容

模型選擇

設定參考

GLM 模型

開始使用

端點

速率限制與超載

設定範例

內建目錄

思考層級

進階設定

相關內容