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 الموفّر أولًا:

bash
openclaw plugins install @openclaw/zai-provider

الاكتشاف التلقائي لنقطة النهاية

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

  • تشغيل الإعداد الأولي

    bash
    openclaw onboard --auth-choice zai-api-key
  • التحقق من ظهور النموذج في القائمة

    bash
    openclaw models list --all --provider zai
  • نقطة نهاية إقليمية محددة صراحةً

    الأنسب لـ: المستخدمين الذين يريدون فرض واجهة Coding Plan أو واجهة API عامة محددة.

  • اختيار خيار الإعداد الأولي المناسب

    bash
    # 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
  • التحقق من ظهور النموذج في القائمة

    bash
    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 إذا كان مفتاحك يعمل على كليهما.

    مثال على الإعداد

    json5
    {  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 المعروفة من دون تحميل وقت تشغيل الموفّر:

    bash
    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. لتعطيله:

    json5
    {  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}
    التفكير المحفوظ

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

    json5
    {  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 معيّنًا.

    ذو صلة

    Was this useful?
    On this page

    On this page