Files
openclaw/docs/debug/node-issue.md
T
Tabula Myriad a9ae1a6778 feat: Triad development iteration complete
Matrix Protocol:
- docker-compose.matrix.yml: Dendrite homeserver + PostgreSQL + Nginx TLS
- src/channels/plugins/matrix-channel.ts: OpenClaw plugin implementation
- docs/matrix-triad-setup.md: Setup guide with auth scheme (@tm1-4:triad.local)

MCP Server Integration:
- docs/mcp-triad-integration.md: SearXNG, Playwright, GitHub MCP configs
- docs/mcp-curiosity-mapping.md: Gap-to-capability mapping

Node Sync Architecture:
- src/services/node-sync-service.ts: WebSocket peer sync + presence detection
- src/services/node-sync-service.test.ts: Unit tests
- docs/node-sync-architecture.md: Architecture docs

Triad Resilience:
- scripts/triad-corruption-check.mjs: SQLite + log + config + git integrity
- docs/triad-resilience.md: Recovery procedures
- .secure/deployment-logs/README.md: Schema v2
- skills/triad-heartbeat/SKILL.md: Corruption check integration

NPM Publish Workflow:
- scripts/npm-publish.mjs: version, changelog, validate, publish, rollback
- .github/workflows/npm-publish.yml: GitHub Actions with provenance
- docs/npm-publish-guide.md: Complete documentation

All deliverables tested in Docker before production.
2026-03-24 00:44:50 -04:00

2.8 KiB
Executable File
Raw Blame History

summary, read_when, title
summary read_when title
Node + tsx "__name is not a function" crash notes and workarounds
Debugging Node-only dev scripts or watch mode failures
Investigating tsx/esbuild loader crashes in OpenClaw
Node + tsx Crash

Node + tsx "__name is not a function" crash

Summary

Running OpenClaw via Node with tsx fails at startup with:

[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

This began after switching dev scripts from Bun to tsx (commit 2871657e, 2026-01-06). The same runtime path worked with Bun.

Environment

  • Node: v25.x (observed on v25.3.0)
  • tsx: 4.21.0
  • OS: macOS (repro also likely on other platforms that run Node 25)

Repro (Node-only)

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

Minimal repro in repo

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

Node version check

  • Node 25.3.0: fails
  • Node 22.22.0 (Homebrew node@22): fails
  • Node 24: not installed here yet; needs verification

Notes / hypothesis

  • tsx uses esbuild to transform TS/ESM. esbuilds keepNames emits a __name helper and wraps function definitions with __name(...).
  • The crash indicates __name exists but is not a function at runtime, which implies the helper is missing or overwritten for this module in the Node 25 loader path.
  • Similar __name helper issues have been reported in other esbuild consumers when the helper is missing or rewritten.

Regression history

  • 2871657e (2026-01-06): scripts changed from Bun to tsx to make Bun optional.
  • Before that (Bun path), openclaw status and gateway:watch worked.

Workarounds

  • Use Bun for dev scripts (current temporary revert).

  • Use Node + tsc watch, then run compiled output:

    pnpm exec tsc --watch --preserveWatchOutput
    node --watch openclaw.mjs status
    
  • Confirmed locally: pnpm exec tsc -p tsconfig.json + node openclaw.mjs status works on Node 25.

  • Disable esbuild keepNames in the TS loader if possible (prevents __name helper insertion); tsx does not currently expose this.

  • Test Node LTS (22/24) with tsx to see if the issue is Node 25specific.

References

Next steps

  • Repro on Node 22/24 to confirm Node 25 regression.
  • Test tsx nightly or pin to earlier version if a known regression exists.
  • If reproduces on Node LTS, file a minimal repro upstream with the __name stack trace.