Node + tsx crash

기준일: 2026-07-26
공식 기준: Node + tsx crash

Node + tsx crash 문서는 OpenClaw 공식 문서(debug/node-issue)를 한국어로 정리한 가이드입니다. Historical Node + tsx "__name is not a function" crash and its cause 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Historical Node + tsx "__name is not a function" crash and its cause

한국어 가이드 범위: debug/node-issue 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Node + tsx "__name is not a function" crash
• 상태
• Original symptom
• Cause
• Current repro check
• Workarounds (if the crash returns)
• References
• 관련 문서

상세 내용

Node + tsx "__name is not a function" crash

이 섹션의 세부 항목은 공식 문서 Node + tsx "__name is not a function" crash를 참고하세요.

상태

Resolved. This crash does not reproduce on the current tsx version pinned in package.json (4.22.3) or on current Node releases. Kept here in case a future tsx/esbuild upgrade reintroduces it.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Original symptom

Running OpenClaw dev scripts through tsx failed at startup with:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

[openclaw] Failed to start CLI: TypeError: __name is not a function
    at createSubsystemLogger (src/logging/subsystem.ts)
    at <caller> (src/agents/auth-profiles/constants.ts)

Cause

tsx transforms TS/ESM through esbuild with keepNames: true hardcoded in its transform options. That setting makes esbuild wrap named function/class declarations in a call to a __name helper so fn.name survives minification and bundling. The crash means the helper was missing or shadowed at the call site for that module in the affected tsx/Node combination, so __name(...) threw instead of returning the wrapped value.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Current repro check

Minimal isolated repro (loads only the module from the original stack trace):

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

node --version
pnpm install
node --import tsx src/entry.ts status

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

Workarounds (if the crash returns)

change and needs approval per repo policy) to bisect whether the esbuild version it bundles reintroduced the bug.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Run dev scripts with Bun instead of node --import tsx.
• Run pnpm tsgo for type checking, then run the built output instead of the
• Try a different tsx version (pnpm add -D tsx@<version> is a dependency
• Test on a different Node major/minor to see whether the failure is version

pnpm tsgo
  node openclaw.mjs status

References

주요 항목:

• https://esbuild.github.io/api/#keep-names
• https://github.com/evanw/esbuild/issues/1031

관련 문서

주요 항목:

• Node.js install
• Gateway troubleshooting

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/debug/node-issue
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

[openclaw] Failed to start CLI: TypeError: __name is not a function
    at createSubsystemLogger (src/logging/subsystem.ts)
    at <caller> (src/agents/auth-profiles/constants.ts)

node --version
pnpm install
node --import tsx src/entry.ts status

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

pnpm tsgo
  node openclaw.mjs status

관련 링크

• 공식 원문: debug/node-issue
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.