docs/docs/id/debug/node-issue.md

read_when	summary	title	x-i18n
Men-debug skrip dev khusus Node atau kegagalan mode watch Menyelidiki crash loader tsx/esbuild di OpenClaw	Catatan crash Node + tsx "__name is not a function" dan solusinya	Crash Node + tsx	generated_at model provider source_hash source_path workflow 2026-04-05T13:52:45Z gpt-5.4 openai f5beab7cdfe7679680f65176234a617293ce495886cfffb151518adfa61dc8dc debug/node-issue.md 15

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

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

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.