跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
開始使用

**最適合：**大多數使用者。OpenClaw 會從金鑰偵測相符的 Z.AI 端點，並自動套用正確的基底 URL。
1

執行初始設定

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

設定預設模型

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
}
3

確認模型已列出

openclaw models list --all --provider zai

​
內建目錄

OpenClaw 會在 Plugin manifest 中隨附內建的 zai 提供者目錄，因此唯讀 清單可以在不載入提供者執行階段的情況下顯示已知的 GLM 列： 
openclaw models list --all --provider zai
目前由 manifest 支援的目錄包含：
模型參照備註
zai/glm-5.1預設模型
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
GLM 模型可用作 zai/<model>（範例：zai/glm-5）。預設的內建模型參照是 zai/glm-5.1。

​
進階設定

未知的 glm-5* ID 仍會在內建提供者路徑上向前解析；當 ID 符合目前 GLM-5 系列形態時，會從 glm-4.7 範本合成提供者擁有的中繼資料。
Z.AI 工具呼叫串流預設啟用 tool_stream。若要停用它：
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
Z.AI 思考會遵循 OpenClaw 的 /think 控制。關閉思考時， OpenClaw 會傳送 thinking: { type: "disabled" }，避免回應在顯示文字前 將輸出預算花在 reasoning_content 上。保留思考需要選擇啟用，因為 Z.AI 要求重播完整歷史 reasoning_content，這會增加提示 token。請依模型啟用：
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
啟用後且思考開啟時，OpenClaw 會傳送 thinking: { type: "enabled", clear_thinking: false }，並為相同的 OpenAI 相容逐字稿重播先前的 reasoning_content。進階使用者仍可使用 params.extra_body.thinking 覆寫確切的提供者酬載。
內建的 Z.AI Plugin 會註冊影像理解。
屬性值
模型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）。

​
相關

GLM 模型系列

GLM 的模型系列概覽。

模型選擇

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