Skip to content

تكامل Zhipu GLM: نقاط النهاية المزدوجة لـ Z.AI و Coding Plan ​

OpenClaw تكامل GLM (Zhipu) هو المحطة الثالثة في صفحة النماذج المحلية. في الدرسين السابقين، DeepSeek اشتغل بمتغير بيئة واحد فقط، وQwen قدّم اختيارًا من ثلاثة؛ أما GLM فسؤال الاختيار فيه أبسط — General API أم Coding Plan، مضروبًا مرة أخرى في الموقع الدولي api.z.ai أم الموقع الصيني open.bigmodel.cn. إذا اخترت نقطة النهاية الخاطئة، سيُرفض المفتاح ولن يتطابق النموذج الافتراضي. تستغرق العملية بأكملها نحو 8 دقيقة (لا يشمل ذلك التسجيل في Z.AI).

إليك أولًا جدولًا سريعًا للنظرة العامة، تنطلق منه كل التهيئات في هذا الدرس (الخصائص والقيم منقولة كما هي من الوثائق الرسمية):

الخاصيةالقيمة
معرّف المزوّد Provider idzai
متغير بيئة المصادقةZAI_API_KEY (الاسم القديم المستعار Z_AI_API_KEY لا يزال مقبولًا، ويُنسخ تلقائيًا عند الإقلاع)
شكل APIZ.AI Chat Completions (مصادقة Bearer)
الإضافة الرسمية@openclaw/zai-provider (إضافة خارجية، تتطلب التثبيت)
النموذج الافتراضيCoding Plan: zai/glm-5.3؛ General API: zai/glm-5.2
وحدة تحكم إدارة المفاتيحhttps://z.ai/manage-apikey/apikey-list

أمر واحد يجب معرفته أولًا: GLM هو عائلة نماذج، وليس مزوّدًا مستقلًا (النص الرسمي: "GLM is a model family, not a separate provider"). مراجع النماذج تبدأ دائمًا بـ zai/، مثل zai/glm-5.3 — المزوّد هو zai، ومعرّف النموذج هو glm-5.3.

أربع نقاط نهاية، يكفيك هذا الجدول طوال الدرس (auth-choice ونقاط النهاية منقولة كما هي من الوثائق الرسمية):

الاستخدامauth-choiceBase URLالنموذج الافتراضي
General API · الموقع الدوليzai-globalhttps://api.z.ai/api/paas/v4glm-5.2
General API · الموقع الصينيzai-cnhttps://open.bigmodel.cn/api/paas/v4glm-5.2
Coding Plan · الموقع الدوليzai-coding-globalhttps://api.z.ai/api/coding/paas/v4glm-5.3
Coding Plan · الموقع الصينيzai-coding-cnhttps://open.bigmodel.cn/api/coding/paas/v4glm-5.3

كيف تختار؟ في ثلاث جمل:

حالتكاختر هذا
اشتركت في GLM Coding Plan (اشتراك شهري للبرمجة)zai-coding-global / zai-coding-cn، والنموذج الافتراضي مباشرة هو glm-5.3
الدفع حسب الاستخدام (pay-as-you-go)zai-global / zai-cn، والنموذج الافتراضي glm-5.2
لست متأكدًا أي نقطة نهاية يعمل معها هذا المفتاحzai-api-key: جرّب OpenClaw نقاط النهاية واحدة تلو الأخرى بالمفتاح، وأول واحدة تقبل فاستخدمها

حقيقتان إضافيتان ستُستخدمان لاحقًا في استكشاف الأخطاء:

  • لدى Z.AI أيضًا نقطة نهاية لخطة Coding Plan متوافقة مع Anthropic https://api.z.ai/api/anthropic — وهي مخصصة للعملاء الذين يتحدثون مباشرة بأسلوب Anthropic Messages؛ خيار zai في OpenClaw لا يستخدمها، بل يسلك نقطة نهاية OpenAI Chat Completions الواردة في الجدول أعلاه.
  • على نقطة النهاية Coding Plan، تُوجَّه طلبات GLM-5.2 / GLM-5.1 بواسطة Z.AI إلى GLM-5.3.

::: نصيحة 💡 للأصدقاء القادمين من البحث في «Zhipu Qingyan» «Zhipu Qingyan» هو منتج المحادثة من Zhipu الموجه للمستخدمين العاديين؛ ما يحتاجه OpenClaw ليس تلك الواجهة الدردشية، بل مفتاح API لنموذج GLM — احصل عليه من وحدة تحكم Z.AI (الموقع الدولي) أو open.bigmodel.cn (المنطقة الصينية). هذه الصفحة تتناول الربط عبر API فقط. :::

يستند هذا البرنامج التعليمي إلى OpenClaw الإصدار v2026.10.9.

ماذا ستستطيع أن تفعل بعد إتمام التعلم ​

  • تثبيت المكون الإضافي الرسمي لـ GLM @openclaw/zai-provider وإدخال ZAI_API_KEY في OpenClaw — الكشف التلقائي، أو نقطة النهاية الصريحة، أو الإعداد اليدوي: ثلاثة مسارات تختار منها
  • التمييز بين نقطتي النهاية المزدوجتين General API و Coding Plan × منطقتي الصين / الدولية، واختيار auth-choice الصحيح وفق مفتاحك
  • فهم الدليل المدمج لـ GLM: مواضع glm-5.3 و glm-5.3-flash و glm-5.2 على حدة، ولماذا يُنصح بعدم استخدام glm-5.1 بعد الآن
  • عدم الذعر عند مواجهة 429 / 1302 / 1305 في أوقات الذروة: التمييز بين «التقييد المؤقت» و«نقطة النهاية الخاطئة»
  • استخدام القدرات الحصرية لـ GLM: مستويات الاستدلال /think، وتوليد الفيديو cogvideox-3، وفهم الصور glm-4.6v

🎒 التحضيرات قبل البدء ​

  • إتمام نظرة عامة على ربط النماذج: نظام provider وتبديل النماذج: أن تكون على دراية بخطوات «تثبيت المكون الإضافي ← إدخال بيانات الاعتماد ← اختيار النموذج» الثلاث وقواعد مرجع provider/model
  • OpenClaw مثبَّت و Gateway يعمل: openclaw gateway status يعطي مخرجات (يسري المكون الإضافي تلقائيًا على Gateway قيد التشغيل؛ وإن لم يكن يعمل فيسري عند الإقلاع التالي)
  • معرفة ما إذا كان مفتاحك من نوع Coding Plan أو دفع حسب الاستخدام، وهل صدر من الموقع الصيني أم الدولي
  • إذا كنت تنشر عبر خادم / خدمة خلفية daemon، فاعرف أين يقع ~/.openclaw/.env — فالمفتاح سيسكن هناك في النهاية

اتبع خطواتي ​

الخطوة 1: إنشاء مفتاح API في وحدة تحكم Z.AI ​

لماذا: OpenClaw مسؤول عن الاستدعاء فقط، والمفتاح يجب الحصول عليه أولًا من جهة Z.AI — كما أن نوع حسابك (اشتراك / دفع حسب الاستخدام) يحدد أي نقطة نهاية ستختار في الخطوة 2.

  1. افتح المتصفح على وحدة تحكم Z.AI https://z.ai/manage-apikey/apikey-list وسجّل / سجّل الدخول
  2. أنشئ مفتاح API واحدًا، وانسخه والصقه في مكان آمن
  3. مستخدمو الصين: المنصة الصينية هي open.bigmodel.cn، وتُدار مفاتيح الحسابات الصينية في وحدة التحكم الخاصة بها (وثائق OpenClaw تعطي رابطًا مباشرًا لوحدة تحكم الموقع الدولي فقط؛ أما موقع الصين فيتم الدخول إليه من الموقع الرسمي open.bigmodel.cn للبحث عن صفحة إدارة API Key)

يجب أن ترى: مفتاح API قابل للنسخ. غير متأكد من نوع حسابك؟ ألقِ نظرة على خطة الاشتراك الحالية في صفحة الاشتراك https://z.ai/subscribe.

الخطوة 2: ربط OpenClaw بـ GLM — ثبّت المكون الإضافي أولًا ثم اضبط ZAI_API_KEY ​

لماذا: zai هو مثل DeepSeek و Qwen مكون إضافي رسمي خارجي (لا يأتي مدمجًا مع النواة)، ويتطلب خطوة «تثبيت» إضافية عن المكونات المدمجة؛ وبعد التثبيت، يحدد auth-choice أي نقطة نهاية ستُستخدم.

ثبّت المكون الإضافي أولًا (الخطوة الأولى المشتركة بين الطريقتين):

bash
openclaw plugins install @openclaw/zai-provider

يجب أن ترى: نجاح التثبيت. يسري تلقائيًا على Gateway قيد التشغيل؛ وإن لم يكن Gateway يعمل فيسري عند الإقلاع التالي.

الطريقة A (موصى بها): المرشد onboarding ​

الأسهل هو الكشف التلقائي — OpenClaw يجرّب نقاط النهاية واحدة تلو الأخرى باستخدام مفتاحك:

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

ترتيب الكشف (كما في الوثائق الرسمية حرفيًا): تُجرَّب أولًا نقطة النهاية General (zai-global ← zai-cn)، ثم نقطة النهاية Coding Plan (zai-coding-global ← zai-coding-cn)، ويُستخدم أول واحدة تقبل الطلب.

لفرض تحديد نقطة نهاية بعينها (يُنصح مستخدمو Coding Plan بالاختيار الصريح، والسبب في تنبيه المخاطر أدناه):

bash
# Coding Plan · 国际站 / 国内站(Coding Plan 用户推荐)
openclaw onboard --auth-choice zai-coding-global
openclaw onboard --auth-choice zai-coding-cn

# General API · 国际站 / 国内站
openclaw onboard --auth-choice zai-global
openclaw onboard --auth-choice zai-cn

يجب أن ترى: أولًا مطالبة بإدخال مفتاح API، ثم حفظ بيانات الاعتماد بعد نجاح التحقق؛ ويقع النموذج الافتراضي وفق نقطة النهاية — Coding Plan هو zai/glm-5.3، و General API هو zai/glm-5.2.

ثلاث ضمانات مطمئنة (منصوص عليها صراحةً في الوثائق الرسمية):

  • onboarding يحتفظ بإدخالات النماذج الموجودة لديك — إعادة التشغيل لن تحذف إعدادات بقية الـ providers
  • إضافة بيانات اعتماد provider جديد** لن **تغيّر نموذجك الافتراضي الحالي — ولتغيير الافتراضي، استخدم openclaw models set من الخطوة 3
  • متغير البيئة القديم Z_AI_API_KEY يظل صالحًا: عند الإقلاع، إذا لم يكن ZAI_API_KEY مضبوطًا، فسيقوم OpenClaw بنسخه تلقائيًا

الطريقة B: تعديل ملف الإعداد يدويًا ​

المكون الإضافي الرسمي في الأصل لا يحتاج إلى كتابة إدخال models.providers — يكفي تثبيت المكون الإضافي وضبط auth واختيار النموذج؛ لا تُكتب إلا إذا أردت تجاوز baseUrl الافتراضي (مثل تثبيت نقطة نهاية Coding Plan أو الموقع الصيني يدويًا). مثال الإعداد الرسمي (كما هو):

json5
{
  env: { vars: { ZAI_API_KEY: "sk-..." } },
  models: {
    providers: {
      zai: {
        // GLM-5.3 uses the Coding Plan endpoint.
        baseUrl: "https://api.z.ai/api/coding/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.3" } } },
}

استبدل baseUrl حسب حاجتك (بالمقارنة مع جدول نقاط النهاية الأربع أعلاه):

أي نقطة نهاية تريدماذا تكتب في baseUrl
Coding Plan · الموقع الدوليhttps://api.z.ai/api/coding/paas/v4
Coding Plan · الموقع الصينيhttps://open.bigmodel.cn/api/coding/paas/v4
General API · الموقع الدوليhttps://api.z.ai/api/paas/v4
General API · الموقع الصينيhttps://open.bigmodel.cn/api/paas/v4

أين يوضع المفتاح: في shell التفاعلي export ZAI_API_KEY="<你的 API Key>"، أو يُكتب في ~/.openclaw/.env (النشر كخدمة خلفية daemon يجب أن يمر من هنا، انظر التحذير أدناه).

::: تحذير ⚠️ هل يعمل Gateway كخدمة خلفية daemon؟ لا تضع المفتاح في shell التفاعلي عندما يعمل Gateway كخدمة launchd / systemd، فإنه لا يرى متغيرات البيئة من export في طرفيتك. اكتب ZAI_API_KEY في ~/.openclaw/.env، أو زوّد تلك العملية بها عبر env.shellEnv في الإعداد. :::

  • في نظرة عامة بيانات الاعتماد لـ openclaw models status، يمكنك رؤية مصدر ZAI_API_KEY في سطر zai

الخطوة 3: اختيار نموذج GLM والتحقق ​

لماذا: النموذج الافتراضي يقع وفق نقطة النهاية (Coding Plan ← glm-5.3، General ← glm-5.2)، وإن كان كافيًا فشغّله أولًا؛ لكن النماذج الستة في الدليل تتقاسم المهام بشكل مختلف، فألقِ نظرة قبل أن تقرر.

انظر الدليل أولًا:

bash
openclaw models list --all --provider zai

يجب أن ترى: دليل GLM المدمج في قائمة المكون الإضافي (مقتطف كما هو من الوثائق الرسمية؛ هذا الدليل يتبع manifest المكون الإضافي، وهو قائمة للقراءة فقط لا تتطلب تحميل وقت تشغيل الـ provider):

مرجع النموذجالسياقملاحظات
zai/glm-5.31,048,576الافتراضي لخطة Coding Plan
zai/glm-5.3-flash1,048,576متعدد الوسائط (نص + صورة)
zai/glm-5.21Mالافتراضي لـ General API
zai/glm-5-turbo200KOpenClaw نموذج نصي محسّن
zai/glm-5v-turbo200Kنموذج coding متعدد الوسائط
zai/glm-5.1—مهمل؛ لا يظهر إذا لم يتم تكوينه؛ توصي الجهة الرسمية بالتحول إلى GLM-5.2

سلوك الدليل الثلاثة، تكتبه ملاحظة الجهة الرسمية بوضوح:

  • التكوين الجديد لخطة Coding Plan يُعين افتراضيًا zai/glm-5.3؛ وتكوين General API يبقى عند zai/glm-5.2
  • على نقاط نهاية Coding Plan، عندما لا يُعرض GLM-5.3 مباشرةً عبر Key أو نقطة النهاية الإقليمية، يتّجه الكشف التلقائي بالتراجع عبر glm-5.1 ثم glm-4.7
  • عندما يستقبل Coding Plan طلبًا بـ GLM-5.2 / GLM-5.1، توجّهه Z.AI إلى GLM-5.3

كيف تختار؟ في ثلاث جمل:

احتياجكاخترهالأساس
مستخدمو Coding Plan، لا تعرف ماذا تختارzai/glm-5.3الافتراضي الرسمي، سياق 1M
تريد أن يرى النموذج الصورzai/glm-5.3-flash (1M) / zai/glm-5v-turbo (200K)الدليل يشير إلى أنهما متعددا الوسائط
دفع حسب الاستخدام، وتريد إمكانية إيقاف التفكير تمامًاzai/glm-5.2thinking افتراضيًا off ويدعم مستوى off (لا يمكن إيقاف GLM-5.3، انظر القدرات الخاصة)

تغيير النموذج الافتراضي:

bash
openclaw models set zai/glm-5.3

يمكن أيضًا التبديل مؤقتًا في الدردشة: /model zai/glm-5.2 يؤثر على الجلسة الحالية فقط، ولعائلة الأوامر راجع دليل سريع لأوامر الدردشة.

أخيرًا التحقق — أرسل رسالة اختبارية:

bash
openclaw agent --agent main --model zai/glm-5.3 --message "用一句话介绍你自己"

(openclaw agent يتطلب تحديد محدِّد جلسة واحد على الأقل، و--agent main يشير إلى الـ agent الافتراضي — يوجد main افتراضيًا في التثبيتات التي أكملت onboarding؛ أو افتح openclaw dashboard Control UI وأرسل مباشرةً في مربع الدردشة)

يجب أن ترى: النموذج يرد بشكل طبيعي، دون أخطاء نقص بيانات الاعتماد أو عدم وجود النموذج. إلى هنا، يصبح ربط OpenClaw بـ GLM مكتملًا.

السعر في جملة واحدة: GLM-5.3 حاليًا نموذج Coding Plan، والتكلفة في الدليل المحلي صفر — الاشتراك يستخدم حصة الباقة ولا يُحاسَب بحسب التوكن؛ أدلة الدفع حسب الاستخدام تتبع تسعير Z.AI الحالي لـ API، وGLM-5.3 Flash يستخدم سعر الدليل حسب الاستخدام (الخصومات المؤقتة لا تؤثر على سعر الدليل). أسعار الباقات وتوافرها تخضع لصفحة اشتراك Z.AI https://z.ai/subscribe.

  • وصل رد على الرسالة الاختبارية من GLM

نقطة تحقق ✅ ​

  • تم تنفيذ openclaw plugins install @openclaw/zai-provider والإضافة موجودة في القائمة
  • auth-choice (أو baseUrl) يتوافق مع نوع Key ومنطقتك: مفتاح Coding Plan يمر عبر نقطة نهاية coding، ومفتاح الدفع حسب الاستخدام يمر عبر نقطة نهاية general
  • يمكن رؤية ZAI_API_KEY الخاص بـ zai في نظرة عامة بيانات الاعتماد لـ openclaw models status
  • يسرد openclaw models list --all --provider zai نماذج سلسلة GLM
  • وصل رد من GLM بعد إرسال الرسالة الاختبارية
  • لم يتم تعيين zai/glm-5.1 كافتراضي (مهمل)

تنبيهات للمزالق ​

❌ تم تكوين مفتاح Coding Plan على نقطة نهاية General (أو العكس) ​

السبب: دليل استكشاف الأخطاء الرسمي واضح جدًا — يجب استخدام مفتاح Coding Plan مع نقطة نهاية Coding Plan (مثل https://api.z.ai/api/coding/paas/v4)، ومفتاح General API مع نقطة نهاية General (مثل https://api.z.ai/api/paas/v4). فشل مستمر بنفس المفتاح + نفس نقطة النهاية يعني على الأرجح رفضًا من جهة provider أو قيدًا من الباقة، وليس تقييدًا عاديًا بسبب الذروة.

الإجراء الصحيح: تحقق من نقطة النهاية أولًا قبل أي شيء آخر:

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

إذا كانت نقطة النهاية خاطئة، فأعد تشغيل onboard واختر auth-choice صراحةً، أو عدّل يدويًا models.providers.zai.baseUrl.

❌ المفتاح يعمل على الجانبين، لكن الكشف التلقائي انتهى إلى General ​

السبب: ترتيب الكشف في zai-api-key هو General أولًا (zai-global ← zai-cn) ثم Coding Plan (zai-coding-global ← zai-coding-cn)، وأول نقطة تقبل تُستخدم. عندما يكون المفتاح صالحًا على كلا نوعي نقاط النهاية، سيُخصص إلى General — فيصبح النموذج الافتراضي glm-5.2 بدلًا من glm-5.3.

الإجراء الصحيح: نفس التوجيه الرسمي — عندما يعمل المفتاح على الجانبين وتريد استخدام Coding Plan، فحدّد صراحةً:

bash
openclaw onboard --auth-choice zai-coding-global   # 国际站
openclaw onboard --auth-choice zai-coding-cn       # 国内站

❌ أخطاء 429 / 1305 في أوقات الذروة، وتظن أن التكوين معطوب ​

السبب: تصنّف Z.AI رسميًا أدوات الـ agent العامة (بما فيها OpenClaw) كـخدمة سعة مُدارة على أساس best-effort — خلال فترات الحمل الاستدلالي العالي (حسب الجهة الرسمية: تقريبًا من الساعة 2–6 مساءً بتوقيت سنغافورة) ستُقيَّد بعض الطلبات مؤقتًا؛ وحدود المعدل وحصة التزامن في Coding Plan مرتبطة بمستوى الباقة وتُعدَّل ديناميكيًا حسب الموارد، وقد يكون التزامن خارج الذروة أعلى.

معاني رموز الأخطاء في وثائق أكواد API الرسمية: 1302 = بلغ الطلب حد المعدل؛ 1305 = الخدمة مثقلة مؤقتًا، حاول لاحقًا.

الإجراء الصحيح: بالنسبة لأخطاء 429 / 1305 المؤقتة في أوقات الذروة، انتظر وأعد المحاولة فقط. وفقط عندما يستمر الفشل خارج أوقات الذروة أو يتركز في نقطة نهاية / نموذج / شكل طلب معين، ارجع للتحقق من التكوين (الأمران في المزلق السابق).

❌ /think off لا يوقف تفكير GLM-5.3 ​

السبب: GLM-5.3 / GLM-5.3-flash يدعمان ثلاثة مستويات فقط هي low / high / max (الافتراضي max)، ولا يدعمان الإيقاف الكامل — فالقيمة الصريحة /think off ستُحوَّل إلى reasoning_effort: "low".

الطريقة الصحيحة: إذا كنت تريد إيقاف التفكير تمامًا (لتوفير ميزانية الإخراج)، فبدّل إلى zai/glm-5.2 — فهو يدعم off / low / high / max كاملة، والقيمة الافتراضية هي off. راجع القدرات الخاصة أدناه.

❌ ما زلت تستخدم zai/glm-5.1 ​

السبب: glm-5.1 أصبح مهملًا، وإذا لم يتم تكوينه في الدليل فلن يظهر؛ وتوصي الجهة الرسمية بالتحول إلى GLM-5.2. على نقطة نهاية Coding Plan، ستُوجَّه طلبات 5.2 / 5.1 بواسطة Z.AI إلى GLM-5.3 — أي أن النموذج الذي تظن أنك تستخدمه ليس هو النموذج الذي يعمل فعليًا.

الطريقة الصحيحة: على General API بدّل إلى zai/glm-5.2؛ وعلى Coding Plan استخدم zai/glm-5.3 مباشرة.

❌ بعد تثبيت Gateway كـ daemon، يصبح المفتاح المُصدَّر عبر export «غير فعّال» ​

السبب: خدمات launchd / systemd لا ترى متغيرات البيئة الخاصة بـ shell التفاعلي — وهو ما تؤكد عليه وثائق كل مزوّد مرارًا وتكرارًا.

الطريقة الصحيحة: اكتب ZAI_API_KEY في ~/.openclaw/.env، أو قدّمه عبر env.shellEnv في التكوين؛ وأعد تشغيل خدمة Gateway بعد تغيير المفتاح.

🔧 القدرات الخاصة بـ GLM (اختياري) ​

بعد تثبيت المكون الإضافي، تأتي معه أربع قدرات خاصة بـ GLM.

مستويات thinking: ثلاث مجموعات من المطابقة ​

النموذجالمستويات المدعومةالافتراضيتفاصيل المطابقة
GLM-5.3 / 5.3-flashlow / high / maxmaxتُطابَق مع حقل reasoning_effort الخاص بـ Z.AI؛ وoff الصريح يُطابَق مع low (لا يمكن إيقافه بالكامل)
GLM-5.2off / low / high / maxofflow / high يُطابَق مع high الخاص بـ Z.AI، وmax يُطابَق مع max، ويُرسَل عبر reasoning_effort
نماذج GLM الأخرىoff / low (يظهر في المحدِّد كـ on)offoff يُرسِل thinking: { type: "disabled" }؛ والمستويات الأخرى لا تُغيّر جسم الطلب وتتبع سلوك الاستدلال الافتراضي لـ Z.AI

استخدمها مباشرة في الدردشة:

text
/think max   # GLM-5.3 المستوى الافتراضي
/think off   # على GLM-5.3 يعادل فعليًا low؛ أما على GLM-5.2 فهو إيقاف حقيقي

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

توليد الفيديو: zai/cogvideox-3 ​

نفس المكون الإضافي ونفس ZAI_API_KEY (أو Z_AI_API_KEY) يمكنه أيضًا تشغيل أداة توليد الفيديو، والنموذج zai/cogvideox-3:

  • الإدخال: نص وصفي (prompt)، أو صورة واحدة بصيغة PNG / JPEG (تُرسَل الملفات المحلية كـ data URI، بحد أقصى 5 ميغابايت)؛ لا يدعم الإشارة إلى فيديو
  • المدة: تُطبَّع إلى 5 أو 10 ثانية
  • الأبعاد: تُطابَق مع أقرب أبعاد مدعومة — 1280x720، 720x1280، 1024x1024، 1920x1080، 1080x1920، 2048x1080، 3840x2160
  • الافتراضي 720P بالوضع الأفقي وبدون صوت؛ audio: true يشغّل الصوت
  • متقدم: providerOptions.quality (speed / quality)، providerOptions.fps (30 / 60)

تعيينه كمزوّد الفيديو الافتراضي (مثال التكوين الرسمي، كما هو):

json5
{
  agents: {
    defaults: {
      mediaModels: {
        video: { primary: "zai/cogvideox-3" },
      },
    },
  },
}

⚠️ الفيديو يمر عبر نقطة نهاية General، ولا يمكن خصمه مباشرة من اشتراك Coding Plan

توليد الفيديو يستخدم نقطة نهاية General /api/paas/v4 الخاصة بالمنطقة التي كوّنتها (دولية / داخلية)؛ أما نقطة نهاية دردشة Coding Plan فتُطابَق مع نقطة نهاية فيديو General في نفس المنطقة — الفيديو يتطلب وصول API وفوترة على تلك النقطة، وليس مدرجًا ضمن حصة Coding Plan الشهرية.

إذا أردت التعامل بشكل منهجي مع الصور المصاحبة والصوت والفيديو، راجع الصور والصوت: إضافة صور للمحتوى وتحويل المقالات إلى صوت.

فهم الصور: glm-4.6v ​

سجّل المكون الإضافي لـ Z.AI قدرة فهم الصور، والنموذج glm-4.6v — يُستخلص تلقائيًا من بيانات اعتماد Z.AI التي كوّنتها، دون حاجة إلى تكوين إضافي.

::: تفاصيل متقدمة: tool_stream وpreserveThinking ومعرّفات GLM-5 غير المعروفة

  • البث المتدفق لاستدعاء الأدوات: tool_stream مفعّل افتراضيًا. لإيقافه، استبدل المعامل في التكوين أدناه بـ tool_stream: false ومفتاح النموذج بـ zai/<模型> المقابل
  • الاحتفاظ بالتفكير (preserveThinking): غير مفعّل افتراضيًا — لأن Z.AI تتطلب إعادة تشغيل سجل reasoning_content الكامل، مما يزيد من prompt token. فعّله لكل نموذج (مثال رسمي، كما هو):
json5
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.3": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}

بعد التفعيل، يُرسَل thinking: { type: "enabled", clear_thinking: false } أثناء التفكير، وتُعاد تشغيل سجل reasoning_content من نفس محادثة OpenAI المتوافقة (preserve_thinking بصيغة snake_case هو اسم بديل). يمكن للمستخدمين المتقدمين استخدام params.extra_body.thinking لتجاوز payload المزوّد بدقة.

  • التحليل التوجيهي للمعرّفات GLM-5 غير المعروفة: المعرّفات glm-5* غير الموجودة في الدليل، ما دامت تطابق نمط عائلة GLM-5 الحالية، سيُركّب لها المزوّد بيانات وصفية باستخدام قالب glm-4.7 لإكمال التحليل :::

الخطوة التالية ​

OpenClaw اكتمل بهذا تكوين GLM لـ Zhipu. تابع عبر الصفحة الخاصة بالنماذج المحلية:

دروس ذات صلة ​

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.