メインコンテンツへスキップ
Z.AI は GLM モデルの API プラットフォームです。GLM 向けの REST API を提供し、 認証には API キーを使用します。Z.AI コンソールで API キーを作成してください。 OpenClaw は Z.AI API キーとともに zai プロバイダーを使用します。
プロパティ値
プロバイダーzai
パッケージ@openclaw/zai-provider
認証ZAI_API_KEY (レガシーエイリアス: Z_AI_API_KEY)
APIZ.AI Chat Completions (Bearer 認証)

​
GLM モデル

GLM はモデルファミリーであり、別のプロバイダーではありません。OpenClaw では、GLM モデルは zai/glm-5.2 のような参照を使用します。プロバイダーは zai、モデル ID は glm-5.2 です。

​
はじめに

まずプロバイダー Plugin をインストールします。 
openclaw plugins install @openclaw/zai-provider
最適な対象: ほとんどのユーザー。OpenClaw は API キーでサポートされている Z.AI エンドポイントをプローブし、正しいベース URL を自動的に適用します。
1

Run onboarding

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

Verify the model is listed

openclaw models list --all --provider zai

​
エンドポイント

オンボーディング選択ベース URLデフォルトモデル
zai-globalhttps://api.z.ai/api/paas/v4glm-5.1
zai-cnhttps://open.bigmodel.cn/api/paas/v4glm-5.1
zai-coding-globalhttps://api.z.ai/api/coding/paas/v4glm-5.2
zai-coding-cnhttps://open.bigmodel.cn/api/coding/paas/v4glm-5.2
zai-api-key は、各エンドポイントの chat-completions API に対してキーをプローブし、 Coding Plan エンドポイント (zai-coding-global、その後 zai-coding-cn) より前に 一般エンドポイント (zai-global、その後 zai-cn) を確認し、リクエストを受け入れる 最初のエンドポイントで停止することで、これら 4 つのいずれかを自動検出します。 キーが両方で機能する場合に Coding Plan エンドポイントを強制するには、明示的な --auth-choice を使用してください。

​
設定例

zai-api-key により、OpenClaw はキーから対応する Z.AI エンドポイントを検出し、 正しいベース URL を自動的に適用できます。特定の Coding Plan または一般 API サーフェスを 強制したい場合は、明示的な地域選択を使用してください。
{
  env: { ZAI_API_KEY: "sk-..." },
  models: {
    providers: {
      zai: {
        // GLM-5.2 uses the Coding Plan endpoint.
        baseUrl: "https://api.z.ai/api/coding/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },
}

​
組み込みカタログ

zai プロバイダー Plugin は Plugin マニフェストにカタログを同梱しているため、読み取り専用の 一覧表示ではプロバイダーランタイムを読み込まずに既知の GLM 行を表示できます。 
openclaw models list --all --provider zai
マニフェストに基づくカタログには現在、次が含まれます。
モデル参照注記
zai/glm-5.2Coding Plan デフォルト、1M コンテキスト
zai/glm-5.1一般 API デフォルト
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)。
Coding Plan セットアップのデフォルトは zai/glm-5.2 です。一般 API セットアップでは zai/glm-5.1 が維持されます。Coding Plan エンドポイントでは、キーまたはプランで GLM-5.2 が 公開されていない場合、自動検出は glm-5.1、その後 glm-4.7 にフォールバックします。GLM の バージョンと可用性は変わる可能性があります。インストール済みバージョンが認識しているカタログを 確認するには、openclaw models list --all --provider zai を実行してください。

​
思考レベル

全範囲: off、low、high、max (デフォルトは off)。OpenClaw は、 リクエストペイロードの reasoning_effort を通じて、low と high を Z.AI の high 推論エフォートに、max を Z.AI の max エフォートにマッピングします。
思考を off に設定すると、表示テキストの前に reasoning_content で出力予算を消費する 応答を避けられます。

​
高度な設定

不明な glm-5* ID は、現在の GLM-5 ファミリー形状に ID が一致する場合、 glm-4.7 テンプレートからプロバイダー所有のメタデータを合成することで、 プロバイダーパス上で引き続き前方解決されます。
Z.AI ツール呼び出しストリーミングでは、tool_stream がデフォルトで有効です。無効にするには:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
保持された思考はオプトインです。Z.AI では履歴全体の reasoning_content を再生する必要があり、 それによりプロンプトトークンが増えるためです。モデルごとに有効化します。
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.2": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
有効化され、思考がオンの場合、OpenClaw は thinking: { type: "enabled", clear_thinking: false } を送信し、同じ OpenAI 互換トランスクリプトの 以前の reasoning_content を再生します。snake_case の preserve_thinking パラメーターキーは エイリアスとして機能します。高度なユーザーは、引き続き 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) を使用してください。
  • レガシー環境変数 Z_AI_API_KEY は引き続き受け付けられます。ZAI_API_KEY が未設定の場合、OpenClaw は起動時にそれを ZAI_API_KEY にコピーします。

​
関連

Model selection

プロバイダー、モデル参照、フェイルオーバー動作の選択。

Configuration reference

プロバイダーとモデル設定を含む、OpenClaw 設定スキーマ全体。