Providers
Z.AI
Z.AI هي منصة API لنماذج GLM. وهي توفر REST APIs لـ GLM وتستخدم مفاتيح API للمصادقة. أنشئ مفتاح API الخاص بك في وحدة تحكم Z.AI. يستخدم OpenClaw المزوّد zai مع مفتاح Z.AI API.
| الخاصية | القيمة |
|---|---|
| المزوّد | 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 Global (recommended for Coding Plan users)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (China region)openclaw onboard --auth-choice zai-coding-cn # General APIopenclaw onboard --auth-choice zai-global # General API CN (China region)openclaw onboard --auth-choice zai-cnالتحقق من إدراج النموذج
openclaw models list --all --provider zaiمثال التكوين
{ env: { ZAI_API_KEY: "sk-..." }, models: { providers: { zai: { // GLM-5.2 uses the Coding Plan endpoint. 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-5 غير المعروفة
لا تزال معرّفات glm-5* غير المعروفة تُحلّ مستقبلًا على مسار المزوّد عبر توليد بيانات وصفية مملوكة للمزوّد من قالب glm-4.7 عندما يطابق المعرّف الشكل الحالي لعائلة GLM-5.
بث استدعاءات الأدوات
يكون tool_stream مفعّلًا افتراضيًا لبث استدعاءات أدوات Z.AI. لتعطيله:
{ agents: { defaults: { models: { "zai/<model>": { params: { tool_stream: false }, }, }, }, },}التفكير والتفكير المحفوظ
يتبع تفكير Z.AI عناصر تحكم /think في OpenClaw. عند إيقاف التفكير، يرسل OpenClaw thinking: { type: "disabled" } لتجنب الردود التي تستهلك ميزانية الإخراج في reasoning_content قبل النص المرئي.
التفكير المحفوظ اختياري لأن Z.AI يتطلب إعادة تشغيل reasoning_content التاريخي الكامل، مما يزيد رموز الموجّه. فعّله لكل نموذج:
{ agents: { defaults: { models: { "zai/glm-5.2": { params: { preserveThinking: true }, }, }, }, },}عند تفعيله وتشغيل التفكير، يرسل OpenClaw thinking: { type: "enabled", clear_thinking: false } ويعيد تشغيل reasoning_content السابق لنفس النص النصي المتوافق مع OpenAI.
لا يزال بإمكان المستخدمين المتقدمين تجاوز حمولة المزوّد الدقيقة باستخدام 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معيّنًا.
