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-providerAuto-detect endpoint
最適な対象: ほとんどのユーザー。OpenClaw は API キーを使ってサポートされている Z.AI エンドポイントをプローブし、正しいベース URL を自動的に適用します。
Run onboarding
openclaw onboard --auth-choice zai-api-keyVerify the model is listed
openclaw models list --all --provider zaiExplicit regional endpoint
最適な対象: 特定の Coding Plan または汎用 API サーフェスを強制したいユーザー。
Pick the right onboarding choice
# 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-cnVerify the model is listed
openclaw models list --all --provider zai設定例
{ 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.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 がデフォルトで有効です。無効にするには:
{ 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 の再生を要求し、プロンプトトークンが増えるためです。モデルごとに有効化します。
{ 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-global、zai-coding-cn、zai-global、zai-cn)を使用してください。 - レガシー環境変数
Z_AI_API_KEYは引き続き受け入れられます。ZAI_API_KEYが未設定の場合、OpenClaw は起動時にそれをZAI_API_KEYにコピーします。