Providers

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 をインストールします。

bash
openclaw plugins install @openclaw/zai-provider

Auto-detect endpoint

最適な対象: ほとんどのユーザー。OpenClaw は API キーを使ってサポートされている Z.AI エンドポイントをプローブし、正しいベース URL を自動的に適用します。

  • Run onboarding

    bash
    openclaw onboard --auth-choice zai-api-key
  • Verify the model is listed

    bash
    openclaw models list --all --provider zai
  • Explicit regional endpoint

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

  • Pick the right onboarding choice

    bash
    # Coding Plan Global (recommended for Coding Plan users)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (China region)openclaw onboard --auth-choice zai-coding-cn # General APIopenclaw onboard --auth-choice zai-global # General API CN (China region)openclaw onboard --auth-choice zai-cn
  • Verify the model is listed

    bash
    openclaw models list --all --provider zai
  • 設定例

    json5
    {  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 行を表示できます。

    bash
    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

    高度な設定

    Forward-resolving unknown GLM-5 models

    不明な glm-5* ID は、ID が現在の GLM-5 ファミリーの形状に一致する場合、 glm-4.7 テンプレートからプロバイダー所有のメタデータを合成することで、 プロバイダーパス上で引き続き前方解決されます。

    Tool-call streaming

    Z.AI のツール呼び出しストリーミングでは、tool_stream がデフォルトで有効です。無効にするには:

    json5
    {  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}
    Thinking and preserved thinking

    Z.AI の thinking は OpenClaw の /think コントロールに従います。thinking がオフの場合、 OpenClaw は、表示されるテキストの前に reasoning_content で出力予算を消費する応答を避けるため、 thinking: { type: "disabled" } を送信します。

    preserved thinking はオプトインです。これは、Z.AI が完全な履歴 reasoning_content の再生を要求し、プロンプトトークンが増えるためです。モデルごとに有効化します。

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

    有効化され、thinking がオンの場合、OpenClaw は thinking: { type: "enabled", clear_thinking: false } を送信し、同じ OpenAI 互換トランスクリプトについて過去の reasoning_content を再生します。

    上級ユーザーは、params.extra_body.thinking で正確なプロバイダーペイロードを引き続き上書きできます。

    Image understanding

    Z.AI Plugin は画像理解を登録します。

    プロパティ
    モデル glm-4.6v

    画像理解は、設定済みの Z.AI 認証から自動解決されます。追加の設定は不要です。

    Auth details
    • Z.AI は API キーによる Bearer 認証を使用します。
    • zai-api-key オンボーディング選択は、キーを使ってサポートされているエンドポイントをプローブし、一致する Z.AI エンドポイントを自動検出します。
    • 特定の API サーフェスを強制したい場合は、明示的な地域選択(zai-coding-globalzai-coding-cnzai-globalzai-cn)を使用してください。
    • レガシー環境変数 Z_AI_API_KEY は引き続き受け入れられます。ZAI_API_KEY が未設定の場合、OpenClaw は起動時にそれを ZAI_API_KEY にコピーします。

    関連

    Was this useful?
    On this page

    On this page