Z.AI

Z.AI は GLM モデル向けの API プラットフォームです。GLM 用の REST API を提供し、 認証には API キーを使用します。Z.AI コンソールで API キーを作成してください。 OpenClaw は、Z.AI API キーとともに zai プロバイダーを使用します。

GLM モデル

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

はじめに

最初にプロバイダー Plugin をインストールします。

openclaw plugins install @openclaw/zai-provider

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

openclaw models list --all --provider zai

# Coding Plan グローバル（Coding Plan ユーザーに推奨）openclaw onboard --auth-choice zai-coding-global # Coding Plan CN（中国リージョン）openclaw onboard --auth-choice zai-coding-cn # 汎用 APIopenclaw onboard --auth-choice zai-global # 汎用 API CN（中国リージョン）openclaw onboard --auth-choice zai-cn

openclaw models list --all --provider zai

エンドポイント

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 zaiopenclaw 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 エンドポイントを使用する必要があります。同じキーとエンドポイントで障害が継続する場合、 通常のピーク負荷によるスロットリングではなく、プロバイダー側の拒否またはプランの制限を 示している可能性があります。

設定例

{  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

マニフェストに基づくカタログには、現在次のものが含まれます。

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

思考レベル

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

高度な設定

{  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}

{  agents: {    defaults: {      models: {        "zai/glm-5.2": {          params: { preserveThinking: true },        },      },    },  },}

関連項目