English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Diagnostics

Plantage de Node + tsx

Crash Node + tsx « __name is not a function »

Résumé

Exécuter OpenClaw via Node avec tsx échoue au démarrage avec :

[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

Cela a commencé après le passage des scripts de développement de Bun à tsx (commit 2871657e, 2026-01-06). Le même chemin d’exécution fonctionnait avec Bun.

Environnement

  • Node : v25.x (observé sur v25.3.0)
  • tsx : 4.21.0
  • OS : macOS (reproduction probablement aussi sur d’autres plateformes qui exécutent Node 25)

Reproduction (Node uniquement)

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

Reproduction minimale dans le dépôt

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

Vérification de version Node

  • Node 25.3.0 : échoue
  • Node 22.22.0 (Homebrew node@22) : échoue
  • Node 24 : pas encore installé ici ; vérification nécessaire

Notes / hypothèse

  • tsx utilise esbuild pour transformer TS/ESM. Le keepNames d’esbuild émet un helper __name et encapsule les définitions de fonctions avec __name(...).
  • Le crash indique que __name existe mais n’est pas une fonction à l’exécution, ce qui implique que le helper est manquant ou écrasé pour ce module dans le chemin du chargeur Node 25.
  • Des problèmes similaires liés au helper __name ont été signalés dans d’autres consommateurs d’esbuild lorsque le helper est manquant ou réécrit.

Historique de régression

  • 2871657e (2026-01-06) : les scripts sont passés de Bun à tsx pour rendre Bun optionnel.
  • Avant cela (chemin Bun), openclaw status et gateway:watch fonctionnaient.

Contournements

  • Utiliser Bun pour les scripts de développement (retour temporaire actuel).

  • Utiliser tsgo pour la vérification de types du dépôt, puis exécuter la sortie construite :

    pnpm tsgo
node openclaw.mjs status

  • Note historique : tsc a été utilisé ici pendant le débogage de ce problème Node/tsx, mais les voies de vérification de types du dépôt utilisent maintenant tsgo.

  • Désactiver le keepNames d’esbuild dans le chargeur TS si possible (empêche l’insertion du helper __name) ; tsx ne l’expose pas actuellement.

  • Tester Node LTS (22/24) avec tsx pour voir si le problème est spécifique à Node 25.

Références

Étapes suivantes

  • Reproduire sur Node 22/24 pour confirmer la régression Node 25.
  • Tester la nightly de tsx ou épingler une version antérieure s’il existe une régression connue.
  • Si la reproduction se produit sur Node LTS, ouvrir une reproduction minimale en amont avec la trace de pile __name.

Lié