الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
الملخص

يفشل تشغيل OpenClaw عبر Node باستخدام tsx عند بدء التشغيل مع: 
[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
بدأ ذلك بعد تبديل سكربتات التطوير من Bun إلى tsx (الالتزام 2871657e، 2026-01-06). كان مسار وقت التشغيل نفسه يعمل مع Bun.

​
البيئة

  • 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.

​
المراجع

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

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

​
ذو صلة