在 OpenClaw 中快速整合 Z.AI GLM 模型

每次想嘗試新的大模型，最煩人的就是得重新翻閱 API 文件，搞清楚每個 Provider 的認證方式和模型路徑。如果你正打算在專案裡加入 GLM 模型，手動處理這些瑣事通常會浪費不少開發時間。

好消息是 OpenClaw 已經內建支援 Z.AI 平台。你只需要準備好 API key，幾行指令就能搞定整合，讓你的 Agent 跑在 GLM-4 上。

需要準備的東西

在開始之前，請確保你已經準備好以下項目：

• Z.AI API key（請到 Z.AI 控制台建立）
• 已安裝好的 OpenClaw 環境

快速開始

要在 OpenClaw 中使用 Z.AI，最快的方法是透過 CLI 進行初始化設定。

1. CLI 設定

你可以使用互動式介面，或是直接帶入 API key：

openclaw onboard --auth-choice zai-api-key
# 或者直接使用非互動式指令
openclaw onboard --zai-api-key "$ZAI_API_KEY"

2. 配置 Config 檔案

在你的配置文件中加入以下片段，將 zai/glm-4.7 設定為預設模型：

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

疑難排解

以下是根據 Z.AI 平台特性的常見注意事項：

• 模型名稱格式：所有 GLM 模型都必須使用 zai/<model> 格式。例如，如果你想用 GLM-4.7，請填寫 zai/glm-4.7。
• 身份驗證失敗：Z.AI 使用 Bearer auth 搭配你的 API key 進行驗證。請檢查你的環境變數 ZAI_API_KEY 是否正確設定且沒有多餘的空白。

如果你在設定過程中遇到其他問題，可以詢問 AI Setup Assistant 獲取即時協助。

下一步

• /providers/glm：查看 GLM 模型家族的完整概覽。