Providers

Z.AI

Z.AI پلتفرم API برای مدل‌های GLM است. این پلتفرم APIهای REST را برای 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 ارائه‌دهنده را نصب کنید:

bash

openclaw plugins install @openclaw/zai-provider

تشخیص خودکار نقطهٔ پایانی

مناسب برای: بیشتر کاربران. OpenClaw با استفاده از کلید API شما نقاط پایانی پشتیبانی‌شدهٔ Z.AI را بررسی می‌کند و URL پایهٔ صحیح را به‌طور خودکار اعمال می‌کند.

اجرای راه‌اندازی اولیه

bash

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

بررسی فهرست‌شدن مدل

bash

openclaw models list --all --provider zai

نقطهٔ پایانی منطقه‌ای صریح

مناسب برای: کاربرانی که می‌خواهند یک سطح API مشخص برای Coding Plan یا API عمومی را اجباری کنند.

انتخاب گزینهٔ صحیح راه‌اندازی اولیه

bash

# Coding Plan سراسری (برای کاربران Coding Plan توصیه می‌شود)openclaw onboard --auth-choice zai-coding-global # Coding Plan چین (منطقهٔ چین)openclaw onboard --auth-choice zai-coding-cn # API عمومیopenclaw onboard --auth-choice zai-global # API عمومی چین (منطقهٔ چین)openclaw onboard --auth-choice zai-cn

بررسی فهرست‌شدن مدل

bash

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`

Z.AI همچنین URL پایهٔ سازگار با Anthropic برای Coding Plan را در https://api.z.ai/api/anthropic منتشر می‌کند. گزینه‌های Z.AI در OpenClaw از نقاط پایانی مستندشدهٔ تکمیل‌های گفت‌وگوی OpenAI در بالا استفاده می‌کنند؛ URL مربوط به Anthropic برای کلاینت‌هایی است که مستقیماً با Anthropic Messages ارتباط برقرار می‌کنند.

zai-api-key با آزمایش کلید شما در API تکمیل گفت‌وگوی هر نقطهٔ پایانی، یکی از این چهار مورد را به‌طور خودکار تشخیص می‌دهد؛ ابتدا نقاط پایانی عمومی (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 مشاهده کردید، صبر کنید و درخواست را دوباره امتحان کنید. اگر خطاها خارج از دوره‌های اوج تکرارپذیرند یا فقط برای یک نقطهٔ پایانی، مدل یا شکل درخواست رخ می‌دهند، ابتدا نقطهٔ پایانی و مدل پیکربندی‌شده را بررسی کنید:

bash

openclaw models list --all --provider zaiopenclaw config get models.providers.zai.baseUrl

کلیدهای Coding Plan باید از یک نقطهٔ پایانی Coding Plan مانند https://api.z.ai/api/coding/paas/v4 استفاده کنند؛ کلیدهای API عمومی باید از یک نقطهٔ پایانی API عمومی مانند https://api.z.ai/api/paas/v4 استفاده کنند. خطاهای مداوم با همان کلید و نقطهٔ پایانی می‌توانند نشان‌دهندهٔ رد درخواست از سوی ارائه‌دهنده یا محدودیت طرح باشند، نه محدودسازی عادی ناشی از بار اوج.

نمونهٔ پیکربندی

json5

{  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" } } },}

کاتالوگ داخلی

Plugin ارائه‌دهندهٔ zai کاتالوگ خود را در مانیفست 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`

فرادادهٔ هزینهٔ توکن کاتالوگ از قیمت‌گذاری فعلی پرداخت به‌ازای مصرف در Z.AI پیروی می‌کند. اشتراک‌های Coding Plan به‌جای صورت‌حساب به‌ازای توکن از سهمیهٔ طرح استفاده می‌کنند؛ برای قیمت‌گذاری و دسترس‌پذیری طرح، صفحهٔ اشتراک زنده را ببینید.

سطوح تفکر

GLM-5.2

دامنهٔ کامل: off، low، high، max (پیش‌فرض off). OpenClaw low و high را به میزان تلاش استدلال high در Z.AI، و max را به میزان تلاش max در Z.AI، از طریق reasoning_effort در محمولهٔ درخواست نگاشت می‌کند.

سایر مدل‌های GLM

فقط کلید دودویی: off و low (در انتخابگرها به‌صورت on نمایش داده می‌شود)، پیش‌فرض off. تنظیم تفکر روی off باعث ارسال thinking: { type: "disabled" } می‌شود؛ هر سطح دیگری محمولهٔ درخواست را دست‌نخورده باقی می‌گذارد (رفتار استدلال پیش‌فرض خود Z.AI اعمال می‌شود).

تنظیم تفکر روی off از پاسخ‌هایی جلوگیری می‌کند که بودجهٔ خروجی را پیش از متن قابل‌مشاهده صرف reasoning_content می‌کنند.

پیکربندی پیشرفته

تفکیک پیش‌رو مدل‌های ناشناختهٔ GLM-5

شناسه‌های ناشناختهٔ glm-5* همچنان در مسیر ارائه‌دهنده به‌صورت پیش‌رو تفکیک می‌شوند؛ به این صورت که وقتی شناسه با شکل فعلی خانوادهٔ GLM-5 مطابقت دارد، فرادادهٔ متعلق به ارائه‌دهنده از الگوی glm-4.7 ساخته می‌شود.

جریان‌سازی فراخوانی ابزار

tool_stream به‌طور پیش‌فرض برای جریان‌سازی فراخوانی ابزار Z.AI فعال است. برای غیرفعال‌کردن آن:

json5

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

تفکر حفظ‌شده

تفکر حفظ‌شده اختیاری است، زیرا Z.AI الزام می‌کند کل reasoning_content تاریخی بازپخش شود که تعداد توکن‌های پرامپت را افزایش می‌دهد. آن را برای هر مدل فعال کنید:

json5

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

وقتی فعال باشد و تفکر روشن باشد، OpenClaw thinking: { type: "enabled", clear_thinking: false } را ارسال می‌کند و reasoning_content قبلی را برای همان رونوشت سازگار با OpenAI بازپخش می‌کند. کلید پارامتر snake_case یعنی preserve_thinking نیز به‌عنوان نام مستعار کار می‌کند.

کاربران پیشرفته همچنان می‌توانند محمولهٔ دقیق ارائه‌دهنده را با params.extra_body.thinking بازنویسی کنند.

درک تصویر

Plugin مربوط به Z.AI قابلیت درک تصویر را ثبت می‌کند.

ویژگی	مقدار
مدل	`glm-4.6v`

درک تصویر به‌طور خودکار از احراز هویت پیکربندی‌شدهٔ Z.AI تفکیک می‌شود و به پیکربندی اضافی نیاز ندارد.

جزئیات احراز هویت

Z.AI برای احراز هویت Bearer از کلید API شما استفاده می‌کند.
گزینهٔ راه‌اندازی اولیهٔ 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 کپی می‌کند.

مرتبط

انتخاب مدل

انتخاب ارائه‌دهندگان، ارجاع‌های مدل و رفتار جایگزینی هنگام خطا.

مرجع پیکربندی

طرح‌وارهٔ کامل پیکربندی OpenClaw، شامل تنظیمات ارائه‌دهنده و مدل.

Was this useful?

Z.AI

مدل‌های GLM

شروع به کار

تشخیص خودکار نقطهٔ پایانی

اجرای راه‌اندازی اولیه

بررسی فهرست‌شدن مدل

نقطهٔ پایانی منطقه‌ای صریح

انتخاب گزینهٔ صحیح راه‌اندازی اولیه

بررسی فهرست‌شدن مدل

نقاط پایانی

محدودیت نرخ و بار اضافی

نمونهٔ پیکربندی

کاتالوگ داخلی

سطوح تفکر

GLM-5.2

سایر مدل‌های GLM

پیکربندی پیشرفته

مرتبط

On this page

Molty