تكامل 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 id | zai |
| متغير بيئة المصادقة | ZAI_API_KEY (الاسم القديم المستعار Z_AI_API_KEY لا يزال مقبولًا، ويُنسخ تلقائيًا عند الإقلاع) |
| شكل API | Z.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-choice | Base URL | النموذج الافتراضي |
|---|---|---|---|
| General API · الموقع الدولي | zai-global | https://api.z.ai/api/paas/v4 | glm-5.2 |
| General API · الموقع الصيني | zai-cn | https://open.bigmodel.cn/api/paas/v4 | glm-5.2 |
| Coding Plan · الموقع الدولي | zai-coding-global | https://api.z.ai/api/coding/paas/v4 | glm-5.3 |
| Coding Plan · الموقع الصيني | zai-coding-cn | https://open.bigmodel.cn/api/coding/paas/v4 | glm-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.
- افتح المتصفح على وحدة تحكم Z.AI
https://z.ai/manage-apikey/apikey-listوسجّل / سجّل الدخول - أنشئ مفتاح API واحدًا، وانسخه والصقه في مكان آمن
- مستخدمو الصين: المنصة الصينية هي
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 أي نقطة نهاية ستُستخدم.
ثبّت المكون الإضافي أولًا (الخطوة الأولى المشتركة بين الطريقتين):
openclaw plugins install @openclaw/zai-providerيجب أن ترى: نجاح التثبيت. يسري تلقائيًا على Gateway قيد التشغيل؛ وإن لم يكن Gateway يعمل فيسري عند الإقلاع التالي.
الطريقة A (موصى بها): المرشد onboarding
الأسهل هو الكشف التلقائي — OpenClaw يجرّب نقاط النهاية واحدة تلو الأخرى باستخدام مفتاحك:
openclaw onboard --auth-choice zai-api-keyترتيب الكشف (كما في الوثائق الرسمية حرفيًا): تُجرَّب أولًا نقطة النهاية General (zai-global ← zai-cn)، ثم نقطة النهاية Coding Plan (zai-coding-global ← zai-coding-cn)، ويُستخدم أول واحدة تقبل الطلب.
لفرض تحديد نقطة نهاية بعينها (يُنصح مستخدمو Coding Plan بالاختيار الصريح، والسبب في تنبيه المخاطر أدناه):
# 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 أو الموقع الصيني يدويًا). مثال الإعداد الرسمي (كما هو):
{
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)، وإن كان كافيًا فشغّله أولًا؛ لكن النماذج الستة في الدليل تتقاسم المهام بشكل مختلف، فألقِ نظرة قبل أن تقرر.
انظر الدليل أولًا:
openclaw models list --all --provider zaiيجب أن ترى: دليل GLM المدمج في قائمة المكون الإضافي (مقتطف كما هو من الوثائق الرسمية؛ هذا الدليل يتبع manifest المكون الإضافي، وهو قائمة للقراءة فقط لا تتطلب تحميل وقت تشغيل الـ provider):
| مرجع النموذج | السياق | ملاحظات |
|---|---|---|
zai/glm-5.3 | 1,048,576 | الافتراضي لخطة Coding Plan |
zai/glm-5.3-flash | 1,048,576 | متعدد الوسائط (نص + صورة) |
zai/glm-5.2 | 1M | الافتراضي لـ General API |
zai/glm-5-turbo | 200K | OpenClaw نموذج نصي محسّن |
zai/glm-5v-turbo | 200K | نموذج 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.2 | thinking افتراضيًا off ويدعم مستوى off (لا يمكن إيقاف GLM-5.3، انظر القدرات الخاصة) |
تغيير النموذج الافتراضي:
openclaw models set zai/glm-5.3يمكن أيضًا التبديل مؤقتًا في الدردشة: /model zai/glm-5.2 يؤثر على الجلسة الحالية فقط، ولعائلة الأوامر راجع دليل سريع لأوامر الدردشة.
أخيرًا التحقق — أرسل رسالة اختبارية:
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 أو قيدًا من الباقة، وليس تقييدًا عاديًا بسبب الذروة.
الإجراء الصحيح: تحقق من نقطة النهاية أولًا قبل أي شيء آخر:
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، فحدّد صراحةً:
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-flash | low / high / max | max | تُطابَق مع حقل reasoning_effort الخاص بـ Z.AI؛ وoff الصريح يُطابَق مع low (لا يمكن إيقافه بالكامل) |
| GLM-5.2 | off / low / high / max | off | low / high يُطابَق مع high الخاص بـ Z.AI، وmax يُطابَق مع max، ويُرسَل عبر reasoning_effort |
| نماذج GLM الأخرى | off / low (يظهر في المحدِّد كـ on) | off | off يُرسِل thinking: { type: "disabled" }؛ والمستويات الأخرى لا تُغيّر جسم الطلب وتتبع سلوك الاستدلال الافتراضي لـ Z.AI |
استخدمها مباشرة في الدردشة:
/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)
تعيينه كمزوّد الفيديو الافتراضي (مثال التكوين الرسمي، كما هو):
{
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. فعّله لكل نموذج (مثال رسمي، كما هو):
{
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. تابع عبر الصفحة الخاصة بالنماذج المحلية:
- الدرس التالي ربط Kimi: مكونان Moonshot وKimi Coding: لماذا يُعد Moonshot وKimi Coding مكونين إضافيين منفصلين بمفتاحين منفصلين
- صفحات النماذج الأخرى (MiniMax وDoubao وHunyuan / Qianfan والنماذج الوسيطة والمحلية) تُفتح من جدول الدروس في نظرة عامة على ربط النماذج
- هل اكتمل تكوين النماذج؟ الاستخدام اليومي يبدأ من الاستخدام اليومي: التعامل بكفاءة مع Claw الخاص بك — Control UI وأوامر الدردشة ونظام الذاكرة كلها في ذلك الفصل