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

Diagnostics

Node + tsx 충돌

Node + tsx "__name is not a function" 크래시

요약

tsx와 함께 Node를 통해 OpenClaw를 실행하면 시작 시 다음 오류로 실패합니다.

[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

이 문제는 개발 스크립트를 Bun에서 tsx로 전환한 뒤 시작되었습니다(커밋 2871657e, 2026-01-06). 동일한 런타임 경로는 Bun에서는 작동했습니다.

환경

  • Node: v25.x(v25.3.0에서 관찰됨)
  • tsx: 4.21.0
  • OS: macOS(Node 25를 실행하는 다른 플랫폼에서도 재현될 가능성이 있음)

재현 방법(Node 전용)

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

저장소의 최소 재현

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

Node 버전 확인

  • Node 25.3.0: 실패
  • Node 22.22.0(Homebrew node@22): 실패
  • Node 24: 아직 여기에 설치되어 있지 않음; 확인 필요

참고 / 가설

  • tsx는 esbuild를 사용해 TS/ESM을 변환합니다. esbuild의 keepNames는 __name 헬퍼를 내보내고 함수 정의를 __name(...)로 감쌉니다.
  • 이 크래시는 런타임에 __name이 존재하지만 함수가 아님을 나타내며, 이는 Node 25 로더 경로에서 이 모듈의 헬퍼가 누락되었거나 덮어써졌음을 의미합니다.
  • 유사한 __name 헬퍼 문제는 헬퍼가 누락되거나 다시 작성될 때 다른 esbuild 소비자에서도 보고된 바 있습니다.

회귀 이력

  • 2871657e(2026-01-06): Bun을 선택 사항으로 만들기 위해 스크립트가 Bun에서 tsx로 변경되었습니다.
  • 그 전에는(Bun 경로) openclaw status와 gateway:watch가 작동했습니다.

우회 방법

  • 개발 스크립트에 Bun을 사용합니다(현재 임시 되돌림).

  • 저장소 타입 검사는 tsgo를 사용한 다음 빌드된 출력을 실행합니다.

    pnpm tsgo
node openclaw.mjs status

  • 과거 참고: 이 Node/tsx 문제를 디버깅하는 동안 여기서 tsc가 사용되었지만, 저장소 타입 검사 레인은 이제 tsgo를 사용합니다.

  • 가능하다면 TS 로더에서 esbuild keepNames를 비활성화합니다(__name 헬퍼 삽입 방지). tsx는 현재 이를 노출하지 않습니다.

  • Node LTS(22/24)를 tsx와 함께 테스트해 이 문제가 Node 25에만 해당하는지 확인합니다.

참고 자료

다음 단계

  • Node 22/24에서 재현해 Node 25 회귀인지 확인합니다.
  • 알려진 회귀가 있는 경우 tsx nightly를 테스트하거나 이전 버전으로 고정합니다.
  • Node LTS에서 재현되면 __name 스택 추적과 함께 최소 재현을 upstream에 제출합니다.

관련 문서