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.2 之類的參照：提供者為 zai，模型 ID 為 glm-5.2。

開始使用

請先安裝提供者外掛：

openclaw plugins install @openclaw/zai-provider

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

openclaw models list --all --provider zai

# Coding Plan 全球端點（建議 Coding Plan 使用者使用）openclaw onboard --auth-choice zai-coding-global # Coding Plan 中國端點（中國地區）openclaw onboard --auth-choice zai-coding-cn # 一般 APIopenclaw onboard --auth-choice zai-global # 一般 API 中國端點（中國地區）openclaw onboard --auth-choice zai-cn

openclaw models list --all --provider zai

端點

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 zaiopenclaw 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: { 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

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

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

思考層級

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

進階設定

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

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

相關內容