Langsung ke konten utama

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.

​
Kegagalan 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 berfungsi dengan Bun.

​
Lingkungan

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

​
Repro (hanya 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 verifikasi

​
Catatan / hipotesis

  • tsx menggunakan esbuild untuk mentransformasi TS/ESM. keepNames milik esbuild menghasilkan helper __name dan membungkus definisi fungsi dengan __name(...).
  • Kegagalan menunjukkan __name ada tetapi bukan fungsi saat runtime, yang menyiratkan helper hilang atau ditimpa untuk modul ini dalam jalur loader Node 25.
  • Masalah helper __name serupa telah dilaporkan pada konsumen esbuild lain ketika helper hilang atau ditulis ulang.

​
Riwayat regresi

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

​
Solusi sementara

  • Gunakan Bun untuk skrip dev (revert sementara saat ini).
  • Gunakan tsgo untuk pemeriksaan tipe repo, lalu jalankan output hasil build: 
    pnpm tsgo
node openclaw.mjs status
  • Catatan historis: tsc digunakan di sini saat men-debug masalah Node/tsx ini, tetapi lane pemeriksaan tipe repo sekarang menggunakan tsgo.
  • Nonaktifkan esbuild keepNames di loader TS jika memungkinkan (mencegah penyisipan helper __name); tsx saat ini tidak mengekspos ini.
  • Uji Node LTS (22/24) dengan tsx untuk melihat apakah masalah ini spesifik Node 25.

​
Referensi

​
Langkah berikutnya

  • Repro pada Node 22/24 untuk mengonfirmasi regresi Node 25.
  • Uji tsx nightly atau pin ke versi sebelumnya jika ada regresi yang diketahui.
  • Jika tereproduksi pada Node LTS, ajukan repro minimal ke upstream dengan stack trace __name.

​
Terkait