البيئة والتصحيح

تعطل Node + tsx

تشرح هذه الصفحة استكشاف تعطل Node.js و tsx عند تشغيل بوابة أو واجهة سطر أوامر OpenClaw (مثل node --import tsx أو السكريبتات التي تستخدم tsx).

الأسباب الشائعة

  • إصدار Node : يتطلب OpenClaw Node 22+. قد تسبب الإصدارات الأقدم تعطل وقت التشغيل أو الوحدات الأصلية.
  • tsx / المحمّل : قد ينتج التعطل عند البدء أو تحميل TypeScript عن إصدار tsx أو ترتيب --import أو محمّلات متعارضة.
  • الذاكرة / الأصلي : الأحمال الكبيرة أو الإضافات الأصلية قد تسبب OOM أو تعطل الذاكرة؛ راجع Node.js للإصدار والبيئة.

فحوصات سريعة

  1. إصدار Node : تشغيل node -v (المتوقع v22 أو أحدث).
  2. إعادة إنتاج بدون tsx : تجربة نفس التدفق باستخدام node فقط و JS مُجمّع مسبقاً لمعرفة ما إذا كان التعطل خاصاً بـ tsx.
  3. التشخيص : استخدام علامات التشخيص (مثل OPENCLAW_DEBUG_*) للحصول على مزيد من السجلات قبل التعطل.

ذات صلة