​

تعطل Node + tsx بسبب الخطأ “__name is not a function”

​

الملخص

[openclaw] Failed to start CLI: TypeError: __name is not a function
    at createSubsystemLogger (.../src/logging/subsystem.ts:203:25)
    at .../src/agents/auth-profiles/constants.ts:25:20

​

البيئة

• Node: ‏v25.x (تمت ملاحظته على v25.3.0)
• tsx: ‏4.21.0
• نظام التشغيل: macOS (ومن المرجح أيضًا أن يظهر في بيئات أخرى تشغّل Node 25)

​

إعادة الإنتاج (Node فقط)

# in repo root
node --version
pnpm install
node --import tsx src/entry.ts status

​

إعادة إنتاج مصغّرة داخل المستودع

node --import tsx scripts/repro/tsx-name-repro.ts

​

التحقق من إصدار Node

• Node 25.3.0: يفشل
• Node 22.22.0 (Homebrew node@22): يفشل
• Node 24: غير مثبّت هنا بعد؛ يحتاج إلى تحقق

​

ملاحظات / فرضية

• يستخدم tsx أداة esbuild لتحويل TS/ESM. يقوم خيار keepNames في esbuild بإخراج مساعد __name ويلف تعريفات الدوال باستخدام __name(...).
• يشير التعطل إلى أن __name موجود لكنه ليس دالة وقت التشغيل، ما يعني ضمنيًا أن هذا المساعد مفقود أو تمت الكتابة فوقه لهذه الوحدة في مسار مُحمِّل Node 25.
• تم الإبلاغ عن مشكلات مشابهة تتعلق بالمساعد __name في مستهلكين آخرين لـ esbuild عندما يكون المساعد مفقودًا أو يُعاد كتابته.

​

سجل الانحدار

• 2871657e (2026-01-06): تم تغيير النصوص من Bun إلى tsx لجعل Bun اختياريًا.
• قبل ذلك (مسار Bun)، كان openclaw status و gateway:watch يعملان.

​

الحلول البديلة

• استخدام Bun لنصوص التطوير (الرجوع المؤقت الحالي).
• استخدام tsgo لفحص أنواع المستودع، ثم تشغيل الخرج المبني:
  pnpm tsgo
  node openclaw.mjs status
  
• ملاحظة تاريخية: تم استخدام tsc هنا أثناء تصحيح مشكلة Node/tsx هذه، لكن مسارات فحص الأنواع في المستودع تستخدم الآن tsgo.
• تعطيل keepNames الخاص بـ esbuild في مُحمِّل TS إن أمكن (فهذا يمنع إدراج المساعد __name)؛ ولا يوفّر tsx حاليًا هذا الخيار.
• اختبار Node LTS (22/24) مع tsx لمعرفة ما إذا كانت المشكلة خاصة بـ Node 25.

​

المراجع

• https://opennext.js.org/cloudflare/howtos/keep_names
• https://esbuild.github.io/api/#keep-names
• https://github.com/evanw/esbuild/issues/1031

​

الخطوات التالية

• إعادة الإنتاج على Node 22/24 لتأكيد ما إذا كان هناك انحدار في Node 25.
• اختبار tsx nightly أو تثبيته على إصدار أقدم إذا كان هناك انحدار معروف.
• إذا أمكن إعادة إنتاجه على Node LTS، فافتح إعادة إنتاج مصغّرة لدى المصدر مع تتبع مكدس __name.