Z.AI

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`）
API	Z.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 を自動的に適用します。

オンボーディングを実行

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

モデルが一覧に表示されることを確認

openclaw models list --all --provider zai

最適な対象: 特定の Coding Plan または汎用 API サーフェスを強制的に使用したいユーザー。

適切なオンボーディングオプションを選択

# Coding Plan グローバル（Coding Plan ユーザーに推奨）
openclaw onboard --auth-choice zai-coding-global

# Coding Plan CN（中国リージョン）
openclaw onboard --auth-choice zai-coding-cn

# 汎用 API
openclaw onboard --auth-choice zai-global

# 汎用 API CN（中国リージョン）
openclaw onboard --auth-choice zai-cn

モデルが一覧に表示されることを確認

openclaw models list --all --provider zai

エンドポイント

オンボーディングオプション	ベース URL	デフォルトモデル
`zai-global`	`https://api.z.ai/api/paas/v4`	`glm-5.1`
`zai-cn`	`https://open.bigmodel.cn/api/paas/v4`	`glm-5.1`
`zai-coding-global`	`https://api.z.ai/api/coding/paas/v4`	`glm-5.2`
`zai-coding-cn`	`https://open.bigmodel.cn/api/coding/paas/v4`	`glm-5.2`

Z.AI は Anthropic 互換の Coding Plan ベース URL https://api.z.ai/api/anthropic も公開しています。OpenClaw の Z.AI オプションは、上記のドキュメント化された OpenAI Chat Completions エンドポイントを使用します。Anthropic URL は、 Anthropic Messages を直接使用するクライアント向けです。 zai-api-key は、各エンドポイントの Chat Completions API に対してキーを検査することで、これら 4 つのいずれかを自動検出します。最初に汎用エンドポイント（zai-global、次に zai-cn）、その後に Coding Plan エンドポイント（zai-coding-global、次に zai-coding-cn）を確認し、リクエストを受け付けた最初のエンドポイントで停止します。キーが両方で機能する場合に Coding Plan エンドポイントを強制するには、明示的な --auth-choice を使用してください。

レート制限と過負荷

Z.AI は、Coding Plan と汎用エージェントツールを、容量が管理されるサービスとして説明しています。Z.AI のドキュメントによると、次のとおりです。

汎用エージェントツールは、 OpenClaw を含め、ベストエフォート方式で提供されます。推論負荷が高い時間帯（通常はシンガポール時間の午後 2～6 時頃）には、一部のリクエストが一時的なレート制限を受ける場合があります。
Coding Plan のレートおよび同時実行数制限は、プランの階層に関連付けられ、リソースの可用性に基づいて動的に調整される場合があります。オフピーク時間帯には、同時実行数が増える場合があります。
API エラーコード 1302は、「リクエストのレート制限に達した」ことを意味します。API エラーコード 1305 は、「サービスが一時的に過負荷になっている可能性があります。後でもう一度お試しください」を意味します。

混雑時間帯に一時的な 429 または 1305 レスポンスが表示された場合は、待ってからリクエストを再試行してください。ピーク時間外でも障害が再現する場合、または特定のエンドポイント、モデル、リクエスト形式でのみ発生する場合は、まず設定されているエンドポイントとモデルを確認してください。

openclaw models list --all --provider zai
openclaw config get models.providers.zai.baseUrl

Coding Plan キーでは、https://api.z.ai/api/coding/paas/v4 などの Coding Plan エンドポイントを使用する必要があります。汎用 API キーでは、https://api.z.ai/api/paas/v4 などの汎用 API エンドポイントを使用する必要があります。同じキーとエンドポイントで障害が継続する場合、通常のピーク負荷によるスロットリングではなく、プロバイダー側の拒否またはプランの制限を示している可能性があります。

設定例

zai-api-key を使用すると、OpenClaw はキーに対応する Z.AI エンドポイントを検出し、正しいベース URL を自動的に適用できます。特定の Coding Plan または汎用 API サーフェスを強制的に使用する場合は、明示的なリージョンオプションを使用してください。

{
  env: { ZAI_API_KEY: "sk-..." },
  models: {
    providers: {
      zai: {
        // GLM-5.2 は Coding Plan エンドポイントを使用します。
        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.2`	Coding 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`

カタログのトークンコストメタデータは、Z.AI の現在の従量課金制の料金に準拠しています。Coding Plan サブスクリプションでは、トークン単位の課金ではなくプランのクォータを使用します。プランの料金と提供状況については、最新のサブスクリプションページを参照してください。

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 を実行してください。

思考レベル

GLM-5.2
その他の GLM モデル

全範囲: off、low、high、max（デフォルトは off）。OpenClaw は、リクエストペイロードの reasoning_effort を介して、low と high を Z.AI の high 推論エフォートに、max を Z.AI の max エフォートにマッピングします。

2 値の切り替えのみ: off と low（選択画面では on と表示）、デフォルトは off。思考を off に設定すると thinking: { type: "disabled" } が送信されます。その他のレベルではリクエストペイロードは変更されません（Z.AI 独自のデフォルトの推論動作が適用されます）。

思考を off に設定すると、表示テキストの前に reasoning_content で出力予算を消費するレスポンスを回避できます。

高度な設定

不明な GLM-5 モデルの前方解決

不明な glm-5* ID でも、ID が現在の GLM-5 ファミリー形式に一致する場合は、 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 にコピーします。

モデルの選択

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

設定リファレンス

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

Overview

Concepts and configuration

Providers

GLM モデル

はじめに

エンドポイント

レート制限と過負荷

設定例

組み込みカタログ

思考レベル

高度な設定

関連項目

モデルの選択

設定リファレンス

​GLM モデル

​はじめに

​エンドポイント

​レート制限と過負荷

​設定例

​組み込みカタログ

​思考レベル

​高度な設定

​関連項目

モデルの選択

設定リファレンス

GLM モデル

はじめに

エンドポイント

レート制限と過負荷

設定例

組み込みカタログ

思考レベル

高度な設定

関連項目