Vai al contenuto principale

​
Arresto anomalo di Node + tsx “__name is not a function”

L’esecuzione di OpenClaw tramite Node con tsx fallisce all’avvio con: 
[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
Questo è iniziato dopo il passaggio degli script di sviluppo da Bun a tsx (commit 2871657e, 2026-01-06). Lo stesso percorso di runtime funzionava con Bun.

​
Ambiente

  • Node: v25.x (osservato su v25.3.0)
  • tsx: 4.21.0
  • OS: macOS (la riproduzione è probabile anche su altre piattaforme che eseguono Node 25)

​
Riproduzione (solo Node)

# nella radice del repo
node --version
pnpm install
node --import tsx src/entry.ts status

​
Riproduzione minima nel repo

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

​
Verifica della versione di Node

  • Node 25.3.0: fallisce
  • Node 22.22.0 (Homebrew node@22): fallisce
  • Node 24: non ancora installato qui; necessita di verifica

​
Note / ipotesi

  • tsx usa esbuild per trasformare TS/ESM. keepNames di esbuild emette un helper __name e avvolge le definizioni di funzione con __name(...).
  • L’arresto anomalo indica che __name esiste ma non è una funzione a runtime, il che implica che l’helper manca oppure è stato sovrascritto per questo modulo nel percorso del loader Node 25.
  • Problemi simili con l’helper __name sono stati segnalati in altri consumer di esbuild quando l’helper manca o viene riscritto.

​
Cronologia della regressione

  • 2871657e (2026-01-06): gli script sono passati da Bun a tsx per rendere Bun facoltativo.
  • Prima di allora (percorso Bun), openclaw status e gateway:watch funzionavano.

​
Soluzioni alternative

  • Usa Bun per gli script di sviluppo (attuale revert temporaneo).
  • Usa Node + tsc watch, quindi esegui l’output compilato: 
    pnpm exec tsc --watch --preserveWatchOutput
node --watch openclaw.mjs status
  • Confermato localmente: pnpm exec tsc -p tsconfig.json + node openclaw.mjs status funziona su Node 25.
  • Disabilita keepNames di esbuild nel loader TS, se possibile (questo evita l’inserimento dell’helper __name); al momento tsx non espone questa opzione.
  • Prova Node LTS (22/24) con tsx per vedere se il problema è specifico di Node 25.

​
Riferimenti

​
Passi successivi

  • Riprodurre su Node 22/24 per confermare la regressione di Node 25.
  • Testare tsx nightly o bloccare a una versione precedente se esiste una regressione nota.
  • Se si riproduce su Node LTS, inviare upstream una riproduzione minima con lo stack trace __name.