Zum Hauptinhalt springen

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.

​
Node + tsx „__name is not a function“-Absturz

​
Zusammenfassung

Das Ausführen von OpenClaw über Node mit tsx schlägt beim Start fehl mit: 
[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
Dies begann nach der Umstellung der Entwicklungsskripte von Bun auf tsx (Commit 2871657e, 2026-01-06). Derselbe Runtime-Pfad funktionierte mit Bun.

​
Umgebung

  • Node: v25.x (beobachtet auf v25.3.0)
  • tsx: 4.21.0
  • OS: macOS (Reproduktion wahrscheinlich auch auf anderen Plattformen, die Node 25 ausführen)

​
Reproduktion (nur Node)

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

​
Minimale Reproduktion im Repo

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

​
Node-Versionsprüfung

  • Node 25.3.0: schlägt fehl
  • Node 22.22.0 (Homebrew node@22): schlägt fehl
  • Node 24: hier noch nicht installiert; muss verifiziert werden

​
Hinweise / Hypothese

  • tsx verwendet esbuild, um TS/ESM zu transformieren. esbuilds keepNames gibt einen __name-Helper aus und umschließt Funktionsdefinitionen mit __name(...).
  • Der Absturz zeigt, dass __name zur Laufzeit existiert, aber keine Funktion ist, was darauf hindeutet, dass der Helper für dieses Modul im Node-25-Loader-Pfad fehlt oder überschrieben wurde.
  • Ähnliche Probleme mit dem __name-Helper wurden in anderen esbuild-Consumern gemeldet, wenn der Helper fehlt oder umgeschrieben wird.

​
Regressionshistorie

  • 2871657e (2026-01-06): Skripte wurden von Bun auf tsx umgestellt, um Bun optional zu machen.
  • Davor (Bun-Pfad) funktionierten openclaw status und gateway:watch.

​
Workarounds

  • Verwenden Sie Bun für Entwicklungsskripte (aktueller temporärer Revert).
  • Verwenden Sie tsgo für die Typprüfung des Repos und führen Sie dann die gebaute Ausgabe aus: 
    pnpm tsgo
node openclaw.mjs status
  • Historischer Hinweis: tsc wurde hier während des Debuggings dieses Node/tsx-Problems verwendet, aber die Typprüfungs-Lanes des Repos verwenden jetzt tsgo.
  • Deaktivieren Sie esbuild keepNames im TS-Loader, falls möglich (verhindert das Einfügen des __name-Helpers); tsx stellt dies derzeit nicht bereit.
  • Testen Sie Node LTS (22/24) mit tsx, um zu sehen, ob das Problem Node-25-spezifisch ist.

​
Referenzen

​
Nächste Schritte

  • Auf Node 22/24 reproduzieren, um die Node-25-Regression zu bestätigen.
  • tsx Nightly testen oder auf eine frühere Version pinnen, falls eine bekannte Regression existiert.
  • Wenn es auf Node LTS reproduzierbar ist, eine minimale Reproduktion upstream mit dem __name-Stacktrace einreichen.

​
Verwandt