2026 年、Anthropic や OpenAI の横にコスト意識のある二言語 LLMを置きたい運用者は、智譜のグローバル API 面である Z.AI 経由の GLM を検討します。macOS 上の OpenClaw では、別プロバイダではなく同梱の zai ランタイムとして公開され、zai/glm-5.1 のようなモデル ref、OpenAI 互換 HTTP、Coding Plan と一般 API のオンボーディング選択が揃います。本稿では ZAI_API_KEY、openclaw.json、モデルフェイルオーバー、JSON と環境プロファイル、429 リトライ、doctor 診断と組み合わせた検証手順を示します。
開示：本記事で言及するクラウド Mac mini レンタルサービスは MacHTML が提供しています。
MacHTML 東京ノードの Apple Silicon Mac mini（公開料金 1 日約 $16.9）では、本番と同じ Node・Keychain 挙動で GLM をステージングできます。公式仕様は OpenClaw GLM プロバイダドキュメントを参照してください。
OpenClaw で GLM を使う理由
GLM は日英混在のエージェントターン、長コンテキスト推論、バッチ向けの価格帯に強みがあります。OpenClaw は zai 経由で他の OpenAI 互換プロバイダと同じツール呼び出し経路を維持します。クラウド Mac mini 上では次の 3 パターンが一般的です。
- 日本語・中国語混在チャンネルのプライマリ
- Anthropic 429 後のセカンダリ（別クォータ）
- テキスト専用プライマリ時の
zai/glm-4.6vによるビジョン
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 が一般的です。OpenClaw の zai-cn / zai-coding-cn オンボーディングで正しいクォータバケットに固定できます。
オンボーディングとシークレット
API キーを git にコミットしないでください。~/.openclaw/.env に置き chmod 600 を適用します。
# キー形状からエンドポイント自動検出
openclaw onboard --auth-choice zai-api-key
# Coding Plan（グローバル）
openclaw onboard --auth-choice zai-coding-global
# Coding Plan（中国）
openclaw onboard --auth-choice zai-coding-cn
# カタログ確認
openclaw models list --provider zai
# デフォルトモデル
openclaw 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 してください。
Coding Plan と一般 API
| auth-choice | 用途 |
|---|---|
zai-api-key | キーからエンドポイント自動検出 |
zai-coding-global | Coding Plan（グローバル） |
zai-coding-cn | Coding Plan（中国） |
zai-global | 一般 API（グローバル） |
zai-cn | 一般 API（中国） |
症状： Coding Plan 残高があるのに HTTP 429 と「残高不足」— 多くは一般 API へトラフィックが向いています。/api/coding/paas/v4 ではなく一般エンドポイントの可能性があるため、zai-coding-* でオンボーディングし直してください。
モデルカタログ
openclaw models list --provider zai でライブ一覧を確認します。2026 年時点の代表的 ref：
| モデル ref | 用途 |
|---|---|
zai/glm-5.1 | デフォルト推論、202k コンテキスト |
zai/glm-5v-turbo | 推論 + 画像入力 |
zai/glm-4.7-flash | 低遅延内部ボット |
zai/glm-4.6v | デフォルトビジョンモデル |
フェイルオーバー連鎖ではプロバイダあたり約 45 秒、ターン全体で約 120 秒 を上限にしてください。
フェイルオーバーとツール互換
連鎖内の GLM はプライマリと同一 JSON ツールスキーマを受け付ける必要があります。本番昇格前に zai/glm-5.1 へ読み取り・書き込み・一覧の 3 種ツール呼び出しをステージングで実行します。テキスト専用 GLM へフォールオーバーする際は画像パートを除去してください。詳細は モデルフェイルオーバー記事を参照してください。
macOS ステージングチェックリスト
- シークレットなしの
openclaw.jsonフィンガープリントを git 外へエクスポート - 正しい地域の auth-choice で
zaiをオンボード openclaw models list --provider zai— GLM 行が 1 件以上- ステージングポートで合成チャット + ツールスモーク
- プライマリ障害をシミュレートし、10 秒以内に GLM が応答することを確認
- 24 時間クリーンなメトリクス後に LaunchAgent を昇格
東京ノードの MacHTML レンタル Mac mini（約 $16.9/日）は、Linux シムではなく本番と同じ macOS 挙動で GLM を検証できます。
FAQ
GLM と智譜の社名は同じですか？
いいえ。GLM はモデルファミリー名で、課金とキーは Z.AI / BigModel 各面で管理されます。
どの環境変数を使うべきですか？
ZAI_API_KEY を推奨します。Z_AI_API_KEY もエイリアスとして受理されます。
GLM は破壊的ツールの Anthropic 代替になりますか？
ツールスキーマのスモークテストと human-in-the-loop 方針のレビュー後のみです。
doctor の頻度は？
zai のシークレット・エンドポイント・デフォルトモデル変更のたび、および本番で週次です。
東京ノードで GLM をステージング
Apple Silicon Mac mini 上で OpenClaw と zai/glm-5.1 を本番同等の macOS 環境で検証。公開料金は 1 日約 $16.9 から。