Z.AI

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

نماذج GLM

GLM هي عائلة نماذج وليست موفّرًا منفصلًا. في OpenClaw، تستخدم نماذج GLM مراجع مثل zai/glm-5.2: الموفّر zai، ومعرّف النموذج glm-5.2.

بدء الاستخدام

ثبّت Plugin الموفّر أولًا:

openclaw plugins install @openclaw/zai-provider

openclaw onboard --auth-choice zai-api-key

openclaw models list --all --provider zai

# Coding Plan العالمي (موصى به لمستخدمي Coding Plan)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (منطقة الصين)openclaw onboard --auth-choice zai-coding-cn # API العامopenclaw onboard --auth-choice zai-global # API العام CN (منطقة الصين)openclaw onboard --auth-choice zai-cn

openclaw models list --all --provider zai

نقاط النهاية

يكتشف zai-api-key تلقائيًا واحدة من هذه النقاط الأربع عبر اختبار مفتاحك مع API إكمالات الدردشة لكل نقطة نهاية، وفحص نقاط النهاية العامة (zai-global، ثم zai-cn) قبل نقاط نهاية Coding Plan (zai-coding-global، ثم zai-coding-cn) والتوقف عند أول نقطة نهاية تقبل الطلب. استخدم --auth-choice صريحًا لفرض نقطة نهاية Coding Plan إذا كان مفتاحك يعمل على كليهما.

حدود المعدّل وحالات الحمل الزائد

تصف Z.AI أدوات الوكيل الخاصة بـ Coding Plan والأغراض العامة بأنها خدمات تُدار وفق السعة. وفقًا لوثائق Z.AI نفسها:

• أدوات الوكيل العامة، بما فيها OpenClaw، تُقدَّم وفق مبدأ بذل أفضل جهد. أثناء ارتفاع حمل الاستدلال، عادةً في الفترة من 2 إلى 6 مساءً بتوقيت سنغافورة، قد تواجه بعض الطلبات حدودًا مؤقتة للمعدّل.
• حدود المعدّل والتزامن في Coding Plan مرتبطة بفئة الخطة ويمكن تعديلها ديناميكيًا استنادًا إلى توافر الموارد. قد يكون التزامن أعلى خارج ساعات الذروة.
• رمز خطأ API ‏1302 يعني «تم بلوغ حد معدّل الطلبات». ويعني رمز خطأ API ‏1305 «قد تكون الخدمة محمّلة فوق طاقتها مؤقتًا، يُرجى المحاولة مرة أخرى لاحقًا».

إذا رأيت استجابة مؤقتة من نوع 429 أو 1305 خلال فترة ازدحام، فانتظر وأعِد محاولة الطلب. إذا تكررت حالات الفشل خارج فترات الذروة، أو حدثت فقط لنقطة نهاية أو نموذج أو شكل طلب واحد، فتحقق أولًا من نقطة النهاية والنموذج المضبوطين:

openclaw models list --all --provider zaiopenclaw config get models.providers.zai.baseUrl

يجب أن تستخدم مفاتيح Coding Plan نقطة نهاية خاصة بـ Coding Plan مثل https://api.z.ai/api/coding/paas/v4؛ ويجب أن تستخدم مفاتيح API العامة نقطة نهاية API عامة مثل https://api.z.ai/api/paas/v4. قد تشير حالات الفشل المستمرة باستخدام المفتاح ونقطة النهاية نفسيهما إلى رفض من جانب الموفّر أو قيد في الخطة، وليس إلى تقييد اعتيادي بسبب حمل الذروة.

مثال على الضبط

{  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

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

مستويات التفكير

يؤدي ضبط التفكير على off إلى تجنب الاستجابات التي تستهلك ميزانية المخرجات على reasoning_content قبل النص المرئي.

الضبط المتقدم

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

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

ذو صلة