메인 콘텐츠로 건너뛰기

​
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 전용)

# 저장소 루트에서
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을 사용합니다(현재 임시 되돌림).
  • Node + tsc watch를 사용한 뒤 컴파일된 출력을 실행합니다: 
    pnpm exec tsc --watch --preserveWatchOutput
node --watch openclaw.mjs status
  • 로컬 확인됨: pnpm exec tsc -p tsconfig.json + node openclaw.mjs status는 Node 25에서 동작합니다.
  • 가능하다면 TS 로더에서 esbuild keepNames를 비활성화합니다(__name 헬퍼 삽입 방지). 현재 tsx는 이를 노출하지 않습니다.
  • 이 문제가 Node 25 전용인지 확인하기 위해 Node LTS(22/24)에서 tsx를 테스트합니다.

​
참고 자료

​
다음 단계

  • Node 22/24에서 재현해 Node 25 회귀인지 확인합니다.
  • 알려진 회귀가 있는지 확인하기 위해 tsx nightly를 테스트하거나 더 이른 버전으로 고정합니다.
  • Node LTS에서도 재현되면 __name 스택 트레이스와 함께 최소 재현 사례를 업스트림에 제출합니다.