Перейти до основного вмісту

​
Збій 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
Це почалося після перемикання dev-скриптів з 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 для dev-скриптів (поточне тимчасове повернення).
  • Використовувати tsgo для перевірки типів у репозиторії, а потім запускати зібраний вивід: 
    pnpm tsgo
node openclaw.mjs status
  • Історична примітка: tsc тут використовувався під час налагодження цієї проблеми Node/tsx, але тепер у репозиторії для перевірки типів використовуються шляхи tsgo.
  • Вимкнути esbuild keepNames у TS-завантажувачі, якщо це можливо (це запобігає вставці допоміжного елемента __name); наразі tsx не надає такого параметра.
  • Перевірити Node LTS (22/24) із tsx, щоб з’ясувати, чи проблема специфічна для Node 25.

​
Посилання

​
Наступні кроки

  • Відтворити на Node 22/24, щоб підтвердити регресію Node 25.
  • Перевірити tsx nightly або зафіксувати попередню версію, якщо відома регресія справді існує.
  • Якщо проблема відтворюється на Node LTS, створити мінімальне відтворення upstream із трасуванням стека __name.