Z.AI

Z.AI هي منصة API لنماذج GLM. توفر REST APIs لـ GLM وتستخدم مفاتيح API للمصادقة. أنشئ مفتاح API الخاص بك في وحدة تحكم Z.AI. يستخدم OpenClaw موفر zai مع مفتاح Z.AI API.

• الموفر: zai
• المصادقة: ZAI_API_KEY
• API: إكمالات الدردشة في Z.AI (مصادقة Bearer)

​

البدء

Auto-detect endpoint

الأفضل لـ: معظم المستخدمين. يكتشف OpenClaw نقطة نهاية Z.AI المطابقة من المفتاح ويطبق عنوان URL الأساسي الصحيح تلقائيا.

1. Run onboarding

   openclaw onboard --auth-choice zai-api-key
   
2. Set a default model

   {
     env: { ZAI_API_KEY: "sk-..." },
     agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
   }
   
3. Verify the model is listed

   openclaw models list --all --provider zai
   

Explicit regional endpoint

الأفضل لـ: المستخدمين الذين يريدون فرض خطة ترميز محددة أو سطح API عام.

1. Pick the right onboarding choice

   # 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 API
   openclaw onboard --auth-choice zai-global
   
   # General API CN (China region)
   openclaw onboard --auth-choice zai-cn
   
2. Set a default model

   {
     env: { ZAI_API_KEY: "sk-..." },
     agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
   }
   
3. Verify the model is listed

   openclaw models list --all --provider zai
   

​

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

يشحن OpenClaw كتالوج موفر zai المضمن في بيان Plugin، لذا يمكن أن يعرض السرد للقراءة فقط صفوف GLM المعروفة دون تحميل وقت تشغيل الموفر:

openclaw models list --all --provider zai

يتضمن الكتالوج المدعوم بالبيان حاليا:

مرجع النموذج	ملاحظات
zai/glm-5.1	النموذج الافتراضي
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). مرجع النموذج المضمن الافتراضي هو zai/glm-5.1.

​

الإعداد المتقدم

Forward-resolving unknown GLM-5 models

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

Tool-call streaming

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

{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}

Thinking and preserved thinking

يتبع التفكير في Z.AI عناصر تحكم /think في OpenClaw. عند إيقاف التفكير، يرسل OpenClaw القيمة thinking: { type: "disabled" } لتجنب الاستجابات التي تستهلك ميزانية الإخراج في reasoning_content قبل النص المرئي.

التفكير المحفوظ اختياري لأن Z.AI يتطلب إعادة تشغيل reasoning_content التاريخي بالكامل، مما يزيد رموز المطالبة. فعله لكل نموذج:

{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.1": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}

عند تمكينه وتشغيل التفكير، يرسل OpenClaw thinking: { type: "enabled", clear_thinking: false } ويعيد تشغيل reasoning_content السابق للنص الحواري نفسه المتوافق مع OpenAI.

لا يزال بإمكان المستخدمين المتقدمين تجاوز حمولة الموفر الدقيقة باستخدام params.extra_body.thinking.

Image understanding

يسجل Plugin Z.AI المضمن فهم الصور.

الخاصية	القيمة
النموذج	glm-4.6v

يتم حل فهم الصور تلقائيا من مصادقة Z.AI المكونة، ولا حاجة إلى إعدادات إضافية.

Auth details

• تستخدم Z.AI مصادقة Bearer مع مفتاح API الخاص بك.
• يكتشف اختيار الإعداد الأولي zai-api-key نقطة نهاية Z.AI المطابقة تلقائيا من بادئة المفتاح.
• استخدم الاختيارات الإقليمية الصريحة (zai-coding-global وzai-coding-cn وzai-global وzai-cn) عندما تريد فرض سطح API محدد.

​

ذات صلة

GLM model family

نظرة عامة على عائلة نماذج GLM.

Model selection

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