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 をインストールします。
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 中国(中国リージョン)openclaw onboard --auth-choice zai-coding-cn # 一般 APIopenclaw onboard --auth-choice zai-global # 一般 API 中国(中国リージョン)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 |
zai-api-key は、各エンドポイントの Chat Completions API に対してキーを検査し、
これら 4 つのいずれかを自動検出します。一般エンドポイント(zai-global、
次に zai-cn)を Coding Plan エンドポイント(zai-coding-global、次に
zai-coding-cn)より先に確認し、リクエストを受け付けた最初のエンドポイントで停止します。
キーが両方で機能する場合に Coding Plan エンドポイントを強制するには、明示的な
--auth-choice を使用してください。
設定例
{ 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 |
思考レベル
GLM-5.2
全範囲: off、low、high、max(デフォルトは off)。OpenClaw は、
low と high を Z.AI の high 推論強度に、max を Z.AI の
max 強度に、リクエストペイロードの reasoning_effort を介してマッピングします。
その他の GLM モデル
二値切り替えのみ: 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へコピーします。