想在 Anthropic 或 OpenAI 旁邊加一顆中英混排、成本可控的 LLM，許多台灣與跨境團隊會選智譜 GLM——透過 Z.AI（智譜全球 API 介面）出貨。在 macOS 的 OpenClaw（2026）裡，GLM 不是外掛黑盒：內建 zai 執行階段提供 zai/glm-5.1 這類模型參照、OpenAI 相容 HTTP，以及可鎖定 Coding Plan 與一般 API 區域的 onboard 選項。本文帶你完成金鑰、openclaw.json、與 openclaw doctor 驗證，並在租用的 Apple Silicon Mac mini 上做預發（MacHTML 公開價約 $16.9/天，亦可依匯率換算新台幣預算）。
揭露：MacHTML 提供本文所述的雲端 Mac mini 租用服務。
請搭配 模型故障轉移與供應商路由、JSON 與環境設定檔、429 重試紀律、doctor 診斷，讓 GLM 進入有文件的鏈路，而不是一次性實驗。
為何選 GLM
GLM 擅長中英混排代理回合、長上下文推理與對價格敏感的批次工作。OpenClaw 透過 zai 走與其他 OpenAI 相容供應商相同的 tool calling。在雲端 Mac mini 上常見三種角色：
- 主模型：繁中／簡中混用的 Slack、Telegram 頻道
- 備援：Anthropic 回 HTTP 429 且配額獨立時
- 視覺：
zai/glm-4.6v，當主模型僅文字
官方參考：OpenClaw GLM 供應商文件、Z.AI 平台。
zai 供應商要點
| 項目 | 值 |
|---|---|
| 供應商 ID | zai |
| 環境變數 | ZAI_API_KEY 或 Z_AI_API_KEY |
| 預設 Base URL | https://api.z.ai/api/paas/v4 |
| 建議主模型 | zai/glm-5.1 |
| 預設影像模型 | zai/glm-4.6v |
| API 形狀 | OpenAI 相容 |
跨境團隊若需中國大陸節點，常用 https://open.bigmodel.cn/api/paas/v4（見 智譜 BigModel）；zai-cn、zai-coding-cn onboard 可避免打錯額度池。
Onboard 與金鑰
切勿把 API 金鑰 commit 進 git。請放在 ~/.openclaw/.env 並 chmod 600。
openclaw onboard --auth-choice zai-api-key
openclaw onboard --auth-choice zai-coding-global
openclaw onboard --auth-choice zai-coding-cn
openclaw models list --provider zaiopenclaw config set agents.defaults.model.primary "zai/glm-5.1"每次變更金鑰或路由後執行 openclaw doctor。
openclaw.json 骨架
{
env: { ZAI_API_KEY: "sk-..." },
agents: {
defaults: {
model: {
primary: "zai/glm-5.1",
fallbacks: ["anthropic/claude-sonnet-4", "openai/gpt-4.1-mini"]
}
}
},
providers: {
zai: { timeoutMs: 45000 }
}
}欄位名稱會隨版本變動——貼上前請與已安裝的 OpenClaw diff。設定檔細節見 JSON／環境變數文。
Coding Plan 與一般 API
| Auth 選項 | 適用 |
|---|---|
zai-api-key | 依金鑰自動偵測端點 |
zai-coding-global | Coding Plan（全球） |
zai-coding-cn | Coding Plan（中國） |
zai-global | 一般 API（全球） |
zai-cn | 一般 API（中國） |
症狀：仍有 Coding Plan 額度卻出現 429「餘額不足」——多半是流量打到一般路徑而非 /api/coding/paas/v4。請用 zai-coding-* 重新 onboard；退避策略見 429 文。
模型目錄建議
以 openclaw models list --provider zai 取得即時目錄。2026 常見 ref：
| 模型 ref | 用途 |
|---|---|
zai/glm-5.1 | 預設推理，202k 上下文 |
zai/glm-5v-turbo | 推理 + 圖像輸入 |
zai/glm-4.7-flash | 低延遲內部 bot |
zai/glm-4.6v | 預設 視覺 模型 |
若 GLM 在故障轉移鏈中，單次嘗試建議上限 45 秒、整輪 120 秒——見 故障轉移指南。
故障轉移與工具相容
備援鏈上的 GLM 必須接受與主模型相同的 JSON 工具 Schema。上線前在預發對 zai/glm-5.1 跑三組固定工具呼叫：讀檔、寫 patch、列目錄。切到純文字 GLM 時請移除影像 part。
macOS 預發清單
- 將
openclaw.json指紋（不含密鑰）匯出至 git ignore 儲存。 - 以正確區域 auth 完成
zaionboard。 openclaw models list --provider zai— 確認至少 1 列 GLM。- 在 預發 埠做合成對話與工具 smoke。
- 模擬主模型故障；GLM 應在 10 秒 內回應。
- 連續 24 小時 指標正常後再提升 LaunchAgent。
透過 MacHTML 租用 Mac mini，可在與正式環境相同的 Node、Keychain 路徑上驗證 GLM——而非 Linux 替身。演練結束可關閉實例；路由表留在 runbook 即可。
常見問題
GLM 就是智譜公司名嗎？
不是——GLM 是模型系列；計費與金鑰在 Z.AI／BigModel。
環境變數用哪個？
優先 ZAI_API_KEY；Z_AI_API_KEY 為別名。
能否用 GLM 取代 Anthropic 做破壞性工具？
僅在工具 Schema smoke 與人機審批策略通過後。
多久跑一次 doctor？
每次變更 zai 密鑰、端點或預設模型；正式環境建議每週——詳見 doctor 文。
在真實 macOS 上預發 GLM（zai）
租用雲端 Mac mini，完成智譜 Z.AI onboard 與 doctor 探針，再將 LaunchAgent 推上正式環境。