Langsung ke konten utama

​
Crash Node + tsx “__name is not a function”

​
Ringkasan

Menjalankan OpenClaw melalui Node dengan tsx gagal saat startup dengan: 
[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
Ini mulai terjadi setelah skrip dev dialihkan dari Bun ke tsx (commit 2871657e, 2026-01-06). Jalur runtime yang sama sebelumnya berfungsi dengan Bun.

​
Lingkungan

  • Node: v25.x (diamati pada v25.3.0)
  • tsx: 4.21.0
  • OS: macOS (repro kemungkinan juga terjadi di platform lain yang menjalankan Node 25)

​
Repro (khusus Node)

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

​
Repro minimal di repo

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

​
Pemeriksaan versi Node

  • Node 25.3.0: gagal
  • Node 22.22.0 (Homebrew node@22): gagal
  • Node 24: belum terpasang di sini; perlu diverifikasi

​
Catatan / hipotesis

  • tsx menggunakan esbuild untuk mentransformasi TS/ESM. keepNames milik esbuild mengeluarkan helper __name dan membungkus definisi fungsi dengan __name(...).
  • Crash ini menunjukkan __name ada tetapi bukan function saat runtime, yang mengindikasikan helper tersebut hilang atau tertimpa untuk modul ini di jalur loader Node 25.
  • Masalah helper __name serupa telah dilaporkan di konsumen esbuild lain ketika helper tersebut hilang atau ditulis ulang.

​
Riwayat regresi

  • 2871657e (2026-01-06): skrip diubah dari Bun ke tsx agar Bun menjadi opsional.
  • Sebelum itu (jalur Bun), openclaw status dan gateway:watch berfungsi.

​
Solusi sementara

  • Gunakan Bun untuk skrip dev (revert sementara saat ini).
  • Gunakan Node + tsc watch, lalu jalankan output hasil kompilasi: 
    pnpm exec tsc --watch --preserveWatchOutput
node --watch openclaw.mjs status
  • Dikonfirmasi secara lokal: pnpm exec tsc -p tsconfig.json + node openclaw.mjs status berfungsi di Node 25.
  • Nonaktifkan keepNames esbuild di loader TS jika memungkinkan (mencegah penyisipan helper __name); saat ini tsx tidak mengekspos ini.
  • Uji Node LTS (22/24) dengan tsx untuk melihat apakah masalah ini khusus Node 25.

​
Referensi

​
Langkah berikutnya

  • Repro di Node 22/24 untuk mengonfirmasi regresi Node 25.
  • Uji tsx nightly atau pin ke versi yang lebih lama jika ada regresi yang diketahui.
  • Jika juga dapat direproduksi di Node LTS, ajukan repro minimal upstream dengan stack trace __name.