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الاكتشاف التلقائي لنقطة النهاية
الأنسب لـ: معظم المستخدمين. يفحص 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 للصين (منطقة الصين)openclaw onboard --auth-choice zai-coding-cn # API العامةopenclaw onboard --auth-choice zai-global # API العامة للصين (منطقة الصين)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 إذا كان مفتاحك
يعمل على كليهما.
مثال على الإعداد
{ 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؛ سياق بحجم مليون |
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.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-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. يعمل مفتاح
المعلمة preserve_thinking المكتوب بصيغة snake_case كاسم بديل.
لا يزال بإمكان المستخدمين المتقدمين تجاوز حمولة الموفّر المحددة باستخدام
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معيّنًا.