Providers
Z.AI
Z.AI پلتفرم API برای مدلهای GLM است. این پلتفرم REST APIهایی برای GLM ارائه میکند و
برای احراز هویت از کلیدهای API استفاده میکند. کلید API خود را در کنسول Z.AI بسازید.
OpenClaw از ارائهدهنده zai همراه با یک کلید API متعلق به Z.AI استفاده میکند.
| ویژگی | مقدار |
|---|---|
| ارائهدهنده | zai |
| بسته | @openclaw/zai-provider |
| احراز هویت | ZAI_API_KEY (نام مستعار قدیمی: Z_AI_API_KEY) |
| API | تکمیلهای چت Z.AI (احراز هویت Bearer) |
مدلهای GLM
GLM یک خانواده مدل است، نه یک ارائهدهنده جداگانه. در OpenClaw، مدلهای GLM از
ارجاعهایی مانند zai/glm-5.2 استفاده میکنند: ارائهدهنده zai، شناسه مدل glm-5.2.
شروع به کار
ابتدا Plugin ارائهدهنده را نصب کنید:
openclaw plugins install @openclaw/zai-providerتشخیص خودکار endpoint
بهترین برای: بیشتر کاربران. OpenClaw endpointهای پشتیبانیشده Z.AI را با کلید API شما بررسی میکند و URL پایه درست را بهصورت خودکار اعمال میکند.
اجرای راهاندازی اولیه
openclaw onboard --auth-choice zai-api-keyبررسی کنید که مدل فهرست شده باشد
openclaw models list --all --provider zaiendpoint منطقهای صریح
بهترین برای: کاربرانی که میخواهند یک Coding Plan مشخص یا سطح API عمومی مشخصی را اجبار کنند.
انتخاب گزینه درست راهاندازی اولیه
# 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بررسی کنید که مدل فهرست شده باشد
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" } } },}کاتالوگ داخلی
Plugin ارائهدهنده zai کاتالوگ خود را در مانیفست Plugin عرضه میکند، بنابراین فهرستکردن
فقطخواندنی میتواند ردیفهای شناختهشده GLM را بدون بارگذاری runtime ارائهدهنده نشان دهد:
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
شناسههای ناشناخته glm-5* همچنان در مسیر ارائهدهنده بهصورت رو به جلو حل میشوند؛
این کار با ساخت فراداده تحت مالکیت ارائهدهنده از قالب glm-4.7 انجام میشود، وقتی شناسه
با شکل فعلی خانواده GLM-5 مطابقت داشته باشد.
استریم فراخوانی ابزار
tool_stream بهطور پیشفرض برای استریم فراخوانی ابزار Z.AI فعال است. برای غیرفعالکردن آن:
{ agents: { defaults: { models: { "zai/<model>": { params: { tool_stream: false }, }, }, }, },}تفکر و تفکر حفظشده
تفکر Z.AI از کنترلهای /think در OpenClaw پیروی میکند. وقتی تفکر خاموش باشد،
OpenClaw مقدار thinking: { type: "disabled" } را میفرستد تا از پاسخهایی جلوگیری کند که
پیش از متن قابل مشاهده، بودجه خروجی را صرف reasoning_content میکنند.
تفکر حفظشده اختیاری است، زیرا Z.AI نیاز دارد کل
reasoning_content تاریخی بازپخش شود، که توکنهای prompt را افزایش میدهد. آن را
برای هر مدل فعال کنید:
{ agents: { defaults: { models: { "zai/glm-5.2": { params: { preserveThinking: true }, }, }, }, },}وقتی فعال باشد و تفکر روشن باشد، OpenClaw مقدار
thinking: { type: "enabled", clear_thinking: false } را میفرستد و
reasoning_content قبلی را برای همان transcript سازگار با OpenAI بازپخش میکند.
کاربران پیشرفته همچنان میتوانند payload دقیق ارائهدهنده را با
params.extra_body.thinking بازنویسی کنند.
درک تصویر
Plugin مربوط به Z.AI درک تصویر را ثبت میکند.
| ویژگی | مقدار |
|---|---|
| مدل | glm-4.6v |
درک تصویر بهصورت خودکار از احراز هویت پیکربندیشده Z.AI حل میشود؛ هیچ پیکربندی اضافی لازم نیست.
جزئیات احراز هویت
- Z.AI با کلید API شما از احراز هویت Bearer استفاده میکند.
- گزینه راهاندازی اولیه
zai-api-keyبا بررسی endpointهای پشتیبانیشده با کلید شما، endpoint متناظر Z.AI را بهصورت خودکار تشخیص میدهد. - وقتی میخواهید یک سطح API مشخص را اجبار کنید، از گزینههای منطقهای صریح (
zai-coding-global،zai-coding-cn،zai-global،zai-cn) استفاده کنید. - متغیر محیطی قدیمی
Z_AI_API_KEYهمچنان پذیرفته میشود؛ اگرZAI_API_KEYتنظیم نشده باشد، OpenClaw هنگام شروع آن را درZAI_API_KEYکپی میکند.
