استكشاف أخطاء gateway في OpenClaw وإصلاحها

عندما لا تكفي صفحة الفرز السريع، تحيلك الوثائق إلى دليل التشغيل المعمّق لـ gateway. وهو فهرس لا جدار من الإصلاحات: سلّم أوامر، والإشارات التي يعرضها gateway السليم، وست صفحات لمجالات الأعراض بروابط داخلية ثابتة. وأنفع أقسامه القائمة القصيرة للأشياء التي تتعطل مباشرة بعد الترقية. إليك الخريطة.

السلّم والصفحات الست

• شغّل أوامر status وgateway status ومتابعة السجلات وdoctor وفحص القنوات بهذا الترتيب؛ والسلامة تعني أن gateway status يعرض محرك تشغيل في حالة running، وفحص اتصال بنتيجة ok، وسطر القدرات، وأن doctor لا يبلغ عن أي مشكلة معيقة في الإعدادات أو الخدمة، وأن الفحص يعرض حالة النقل الحية لكل حساب مع علامة works أو audit ok حيثما كان ذلك مدعومًا.
• تغطي صفحة التحديثات والتراجع الحالة التي يترك فيها تحديث أو خفض إصدار أو تثبيت منقسم (split-brain) خدمة gateway متوقفة أو غير متطابقة: ما بعد التحديث، ومهلة نشر محرك النموذج المعدّ، وحاجز الإعدادات الأحدث، وإصلاح مسار البحث، وإعادة تثبيت الخدمة، وإزالة الأغلفة القديمة، وعدم تطابق البروتوكول بعد التراجع. وتغطي صفحة المهارات ومزوّدي النماذج جذر مهارات تم تخطيه، وخطأ تجاوز حد المعدل للسياق الطويل مع إصلاحاته عبر النافذة القياسية وبيانات الاعتماد المؤهلة والنموذج الاحتياطي، والاستجابات المحظورة في المصدر (upstream)، وواجهة خلفية محلية متوافقة مع OpenAI تنجح في الفحوص لكنها تفشل في عمليات تشغيل الوكيل.
• وتغطي صفحة ردود الوكيل وواجهة التحكم تشغيلًا يفشل بخطأ تخزين، وعدم وصول أي رد، واتصال لوحة التحكم، وبصمات أخطاء الاتصال والمصادقة مع خريطة سريعة لرموز تفاصيل المصادقة وتحدي الاتصال، وخطوات توقيع الحمولة وnonce الجهاز. وتغطي صفحة خدمة gateway وعمليتها خدمة لا تعمل أو لا تبقى قيد التشغيل، وgateway على macOS يتوقف بصمت إلى أن تُلمس لوحة التحكم، وحلقة مشرف مع وكلاء تشغيل (launch agents) مكررين، وخروجًا تحت استهلاك مرتفع للذاكرة.
• وتغطي صفحة التحقق من الإعدادات والفحوص إعدادات غير صالحة مرفوضة: ما الذي حدث، والفحص والإصلاح، وبصماتها الشائعة وخيارات إصلاحها، وتحذيرات فحص gateway. وتغطي صفحة تسليم القنوات والأدوات قناة متصلة لا تتدفق فيها الرسائل، والتسليم المجدول وتسليم نبض القلب (heartbeat)، وعقدة مقترنة تفشل أداتها، وإخفاقات أداة المتصفح، وبصمات أخطاء المكونات الإضافية والملفات التنفيذية، وبصمات أخطاء جلسات المتصفح، وبصمات أخطاء العناصر ولقطات الشاشة والرفع؛ وكل رابط داخلي قديم في الصفحة الواحدة السابقة لا يزال يؤدي إلى موضعه الجديد.

معظم الأعطال بعد الترقية سببها انحراف الإعدادات أو قيم افتراضية أكثر صرامة باتت تُطبّق الآن.

إذا أجريت ترقية وتعطل شيء ما

يحتفظ الفهرس بثلاثة فحوص ضمن الصفحة نفسها. أولًا، سلوك تجاوز المصادقة والرابط: اقرأ وضع gateway والرابط البعيد ووضع المصادقة، لأنه عندما يكون الوضع مضبوطًا على remote قد يكون سطر الأوامر موجّهًا إلى gateway بعيد بينما الخدمة المحلية سليمة، واستدعاءات الرابط الصريح لا تعود إلى بيانات الاعتماد المخزنة؛ وتعني بصمة connect-failed أن هدف الرابط خاطئ، وتعني بصمة unauthorized أن نقطة النهاية قابلة للوصول لكن بمصادقة خاطئة. ثانيًا، ضوابط الربط والمصادقة أصبحت أكثر صرامة: يحتاج الربط على عنوان غير loopback إلى مسار مصادقة صالح، أي رمز أو كلمة مرور مشتركة أو وكيل موثوق غير loopback مهيأ بشكل صحيح، ومفتاح الرمز القديم لا يحل محل مفتاح رمز المصادقة الحالي؛ والبصمتان هنا هما رفض الربط دون مصادقة، وفشل فحص الاتصال مع أن المحرك في حالة running. ثالثًا، حالة الإقران وهوية الجهاز: اعرض قوائم الأجهزة وعمليات إقران القنوات، وابحث عن موافقات أجهزة معلّقة للوحة التحكم أو العُقد، وعن موافقات معلّقة بعد تغيير في السياسة أو الهوية؛ والبصمتان هنا هما device identity required وpairing required. وإذا ظلت إعدادات الخدمة والمحرك غير متطابقين، فأعد تثبيت البيانات الوصفية للخدمة من ملف التعريف ودليل الحالة نفسيهما ثم أعد التشغيل.

قراءة الإشارات

• محرك في حالة running مع فحص اتصال فاشل هو التركيبة الأكثر دلالة على الإطلاق: العملية حية لكن سطر الأوامر لا يستطيع الوصول إليها بالرابط والمصادقة الحاليين، لذا فالإصلاح في الوضع أو الرابط أو الرمز، لا في الخدمة.
• ظهور بصمة device identity required بعد الترقية ليس خللًا في العميل؛ فمصادقة الأجهزة أصبحت مفروضة الآن، ولوحة التحكم أو العقدة تحتاج إلى الموافقة المعلّقة الخاصة بها، وهي ما تعرضه قائمتا الأجهزة والإقران.
• الفحص يجري لكل حساب على حدة: فالقناة التي لها حسابان قد تعرض نقلًا يعمل وآخر يفشل، وهو ما لا يكشفه سطر الحالة وحده.

صفحة استكشاف أخطاء القنوات في OpenClaw وإصلاحها هي الرفيق على مستوى القنوات للحالة التي يتصل فيها النقل لكن السلوك خاطئ، وتشرح صفحة OpenClaw doctor أمر الإصلاح الذي يعتمد عليه السلّم.

لماذا فهرس

يؤدي تقسيم دليل التشغيل حسب مجال الأعراض إلى إبقاء كل صفحة قصيرة بما يكفي لقراءتها بينما هناك شيء متوقف، والروابط الداخلية المحفوظة تعني أن الروابط الواردة من سلاسل النقاش والتذاكر القديمة لا تزال تصل إلى القسم الصحيح. وترتيب السلّم مقصود كذلك: فهو ينتقل من الإشارة الأوسع إلى الأضيق، ويأتي doctor قبل الفحص لأنه يصلح أخطاء الإعدادات التي كان الفحص سيبلغ عنها بخلاف ذلك على أنها إخفاقات. تغطي صفحة الإقران في OpenClaw الموافقات التي يبحث عنها الفحص الثالث، وتغطي صفحة إعدادات OpenClaw المفاتيح التي يقرؤها الفحصان الأولان.

على Diali

على Diali، تُولّد إعدادات المحرك من لوحة التحكم وتُستبدل مع كل إصدار، ما يزيل معظم الانحراف الذي يصفه قسم ما بعد الترقية، ويعمل السلّم نفسه على المحرك المستضاف. تصف صفحة OpenClaw المستضاف على Diali المساعد المستضاف، وتصف صفحة الأمان في Diali الحدود المحيطة به.

• خمسة أوامر بالترتيب؛ محرك في حالة running مع فحص بنتيجة ok يعني السلامة.
• ست صفحات للأعراض؛ وكل رابط داخلي قديم لا يزال يعمل.
• بعد الترقية: الوضع والرابط، والربط والمصادقة، وحالة الإقران.