يبلّغك OpenClaw بانتهاء مهلة طلب LLM

انتهاء مهلة طلب النموذج من أوائل الأخطاء التي يصادفها الناس بعد تحويل OpenClaw إلى نموذج محلي، وصفحات استكشاف الأخطاء وإصلاحها في التوثيق تعطيه قائمة قصيرة من الأسباب. معظمها يتعلق بالواجهة الخلفية المحلية: نموذج كبير يُحمَّل من حالة باردة، أو نافذة سياق لا يتحملها العتاد، أو مضيف يرد على curl ولا يرد على Gateway. واثنان منها يتعلقان بالمزوّدين المستضافين: حد معدل متنكر في صورة 429، وحظر في المنبع متنكر في صورة 403. إليك كل سبب مع حله، بالترتيب الذي يقترح التوثيق تجربتها به.

الأسباب المحلية

• نموذج بارد: قد تحتاج النماذج المحلية الكبيرة إلى تحميل أول طويل. خصّص مهلة أطول لمزوّد Ollama، ومثال التوثيق 300 ثانية، واحتفظ بالنموذج محمّلًا بين الأدوار بمعامل keep-alive على إدخال النموذج؛ والإعداد نفسه يمدد أيضًا مهلة الاتصال عندما يكون المضيف بطيئًا في قبول الاتصالات.
• نافذة سياق كبيرة جدًا: كثير من النماذج تعلن عن سياقات لا يستطيع العتاد تشغيلها بارتياح. ضع حدًا لكل من ميزانية الرموز في OpenClaw وسياق الطلب على إدخال النموذج، لتحصل على زمن استجابة متوقع لأول رمز.
• مضيف يعمل مع curl لكن لا يعمل مع OpenClaw: تحقق من الجهاز وبيئة التشغيل اللذين يشغّلان Gateway، لأن عنوان URL أساسيًا يقول localhost لا يشير إلى أي مكان من داخل حاوية Docker، وقد يحمل العنوان اللاحقة المتوافقة مع OpenAI التي تغيّر السلوك، وقد يحتاج المضيف البعيد إلى تغييرات في جدار الحماية أو في عنوان الربط، وقد يكون النموذج على الخدمة الخلفية (daemon) في الحاسوب المحمول لا على الخدمة البعيدة.

قد تحتاج النماذج المحلية الكبيرة إلى تحميل أول طويل.

الواجهة الخلفية التي تجتاز الفحوص وتفشل مع ذلك

في صفحة استكشاف أخطاء المزوّدين حالة لواجهة خلفية محلية متوافقة مع OpenAI تجيب عن الطلبات المباشرة الصغيرة ومع ذلك تفشل في تشغيلات الوكيل: النقل على الأرجح سليم، والواجهة الخلفية تفشل أمام شكل المطالبة الأكبر في محرك الوكيل، ومثال التوثيق Gemma على بعض إصدارات llama-server. ورسالة الدور غير المكتمل بلا حمولات تعني أن الواجهة الخلفية أكملت الطلب لكنها لم تُعد أي نص مرئي؛ ويعيد OpenClaw محاولة هذا الدور مرة واحدة. وإذا قلّت الإخفاقات بعد تعطيل الأدوات لكنها لم تختف، فمخططات الأدوات كانت جزءًا من الضغط، والباقي يعود إلى قدرة الواجهة الخلفية أو إلى خلل برمجي.

الأسباب لدى المزوّدين المستضافين

• خطأ 429 يقول إن استخدامًا إضافيًا مطلوب للسياق الطويل: نموذج Anthropic المحدد له نافذة أصلية بمليون رمز، أو أن إعدادًا قديمًا ما زال يحمل خيار السياق الطويل القديم، وبيانات الاعتماد غير مؤهلة. انتقل إلى نافذة قياسية، أو استخدم بيانات اعتماد مؤهلة أو مفتاح API، واضبط نماذج احتياطية كي تستمر التشغيلات.
• خطأ 403 عام يقول إن الطلب حُظر: ليس دائمًا مشكلة في OpenClaw؛ فقد يأتي من CDN، أو WAF، أو قاعدة لإدارة البوتات، أو خادم وسيط عكسي أمام نقطة نهاية متوافقة مع OpenAI، لذا تحقق من الحالة (status)، ومن حالة Gateway، ومن السجلات قبل تغيير الإعداد.
• عنوان URL الخاطئ: اللاحقة المتوافقة مع OpenAI على مضيف Ollama تعطّل استدعاء الأدوات وقد تجعل النموذج يطبع JSON الأدوات كنص؛ والحل هو العنوان الأصلي، دون اللاحقة.

في مقال OpenClaw مع Ollama صفحة النماذج المحلية كاملة، ومقال OpenClaw لا يستجيب هو السلّم الذي تتبعه عندما يكون ما تلاحظه صمتًا لا انتهاء مهلة.

كيف تبحث

يبدأ كل واحد من هذه الأسباب بالأوامر الثلاثة نفسها التي يكررها التوثيق: تتبّع السجلات، والتحقق من حالة النماذج، وقراءة إعداد النماذج. يشرح مقال سجلات OpenClaw مكان الملف وكيفية متابعته.

على Diali

على Diali، النماذج مستضافة وضبط المهل من مسؤوليتنا، لذا لا ينطبق النصف المحلي من هذه القائمة؛ أما النصف المستضاف فيعالجه التوجيه الاحتياطي قبل أن يضيع أي رد. وتعرض صفحة OpenClaw المستضاف على Diali المساعد.

• نموذج بارد: مهلة أطول للمزوّد وkeep-alive.
• سياق أكبر مما ينبغي: ضع حدًا للميزانية ولسياق الطلب.
• خطأ 429 أو 403 مصدره المزوّد، لا Gateway.