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

الاكتشاف التلقائي لنقطة النهاية
نقطة نهاية إقليمية صريحة

الأنسب لـ: معظم المستخدمين. يفحص OpenClaw نقاط نهاية Z.AI المدعومة باستخدام مفتاح API الخاص بك ويطبّق عنوان 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 CN (منطقة الصين)
openclaw onboard --auth-choice zai-coding-cn

# API العام
openclaw onboard --auth-choice zai-global

# API العام CN (منطقة الصين)
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 تلقائيًا واحدة من هذه النقاط الأربع عبر اختبار مفتاحك مع API إكمالات الدردشة لكل نقطة نهاية، وفحص نقاط النهاية العامة (zai-global، ثم zai-cn) قبل نقاط نهاية Coding Plan (zai-coding-global، ثم zai-coding-cn) والتوقف عند أول نقطة نهاية تقبل الطلب. استخدم --auth-choice صريحًا لفرض نقطة نهاية Coding Plan إذا كان مفتاحك يعمل على كليهما.

حدود المعدّل وحالات الحمل الزائد

تصف Z.AI أدوات الوكيل الخاصة بـ Coding Plan والأغراض العامة بأنها خدمات تُدار وفق السعة. وفقًا لوثائق Z.AI نفسها:

أدوات الوكيل العامة، بما فيها OpenClaw، تُقدَّم وفق مبدأ بذل أفضل جهد. أثناء ارتفاع حمل الاستدلال، عادةً في الفترة من 2 إلى 6 مساءً بتوقيت سنغافورة، قد تواجه بعض الطلبات حدودًا مؤقتة للمعدّل.
حدود المعدّل والتزامن في Coding Plan مرتبطة بفئة الخطة ويمكن تعديلها ديناميكيًا استنادًا إلى توافر الموارد. قد يكون التزامن أعلى خارج ساعات الذروة.
رمز خطأ API ‏1302 يعني «تم بلوغ حد معدّل الطلبات». ويعني رمز خطأ API ‏1305 «قد تكون الخدمة محمّلة فوق طاقتها مؤقتًا، يُرجى المحاولة مرة أخرى لاحقًا».

إذا رأيت استجابة مؤقتة من نوع 429 أو 1305 خلال فترة ازدحام، فانتظر وأعِد محاولة الطلب. إذا تكررت حالات الفشل خارج فترات الذروة، أو حدثت فقط لنقطة نهاية أو نموذج أو شكل طلب واحد، فتحقق أولًا من نقطة النهاية والنموذج المضبوطين:

openclaw models list --all --provider zai
openclaw 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. قد تشير حالات الفشل المستمرة باستخدام المفتاح ونقطة النهاية نفسيهما إلى رفض من جانب الموفّر أو قيد في الخطة، وليس إلى تقييد اعتيادي بسبب حمل الذروة.

مثال على الضبط

يتيح zai-api-key لـ OpenClaw اكتشاف نقطة نهاية Z.AI المطابقة من المفتاح وتطبيق عنوان URL الأساسي الصحيح تلقائيًا. استخدم الخيارات الإقليمية الصريحة عندما تريد فرض سطح Coding Plan أو API عام محدد.

{
  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 المعروفة من دون تحميل وقت تشغيل الموفّر:

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 بصيغة zai/<model> (مثال: zai/glm-5).

يستخدم إعداد Coding Plan القيمة zai/glm-5.2 افتراضيًا؛ بينما يحتفظ إعداد API العام بالقيمة zai/glm-5.1. في نقاط نهاية Coding Plan، يعود الاكتشاف التلقائي احتياطيًا إلى glm-5.1 ثم glm-4.7 عندما لا يتيح المفتاح أو الخطة GLM-5.2. قد تتغير إصدارات GLM ومدى توافرها؛ شغّل openclaw models list --all --provider zai لرؤية الكتالوج المعروف لإصدارك المثبّت.

مستويات التفكير

GLM-5.2
نماذج GLM الأخرى

النطاق الكامل: off، وlow، وhigh، وmax (الافتراضي off). يعيّن OpenClaw القيمتين low وhigh إلى جهد الاستدلال high في Z.AI، والقيمة max إلى جهد max في Z.AI، عبر reasoning_effort في حمولة الطلب.

تبديل ثنائي فقط: off وlow (تظهر بصيغة on في أدوات الاختيار)، والافتراضي off. يؤدي ضبط التفكير على off إلى إرسال thinking: { type: "disabled" }؛ ويترك أي مستوى آخر حمولة الطلب من دون تغيير (يُطبَّق سلوك الاستدلال الافتراضي الخاص بـ Z.AI).

يؤدي ضبط التفكير على off إلى تجنب الاستجابات التي تستهلك ميزانية المخرجات على reasoning_content قبل النص المرئي.

الضبط المتقدم

الحلّ التقدمي لنماذج GLM-5 غير المعروفة

تظل معرّفات glm-5* غير المعروفة قابلة للحلّ التقدمي عبر مسار الموفّر من خلال إنشاء بيانات وصفية مملوكة للموفّر من قالب glm-4.7 عندما يتطابق المعرّف مع الشكل الحالي لعائلة GLM-5.

بث استدعاءات الأدوات

يكون tool_stream مفعّلًا افتراضيًا لبث استدعاءات أدوات Z.AI. لتعطيله:

{
  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 } ويعيد تشغيل 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 المطابقة تلقائيًا عبر اختبار نقاط النهاية المدعومة باستخدام مفتاحك.
استخدم الخيارات الإقليمية الصريحة (zai-coding-global، وzai-coding-cn، وzai-global، وzai-cn) عندما تريد فرض سطح API محدد.
لا يزال متغير البيئة القديم Z_AI_API_KEY مقبولًا؛ ينسخه OpenClaw إلى ZAI_API_KEY عند بدء التشغيل إذا لم تكن ZAI_API_KEY مضبوطة.

ذو صلة

اختيار النموذج

اختيار الموفّرين ومراجع النماذج وسلوك تجاوز الفشل.

مرجع الضبط

مخطط ضبط OpenClaw الكامل، بما في ذلك إعدادات الموفّر والنموذج.

Overview

Concepts and configuration

Providers

نماذج GLM

بدء الاستخدام

نقاط النهاية

حدود المعدّل وحالات الحمل الزائد

مثال على الضبط

الكتالوج المضمّن

مستويات التفكير

الضبط المتقدم

ذو صلة

اختيار النموذج

مرجع الضبط

​نماذج GLM

​بدء الاستخدام

​نقاط النهاية

​حدود المعدّل وحالات الحمل الزائد

​مثال على الضبط

​الكتالوج المضمّن

​مستويات التفكير

​الضبط المتقدم

​ذو صلة

اختيار النموذج

مرجع الضبط

نماذج GLM

بدء الاستخدام

نقاط النهاية

حدود المعدّل وحالات الحمل الزائد

مثال على الضبط

الكتالوج المضمّن

مستويات التفكير

الضبط المتقدم

ذو صلة