Containers

Bun(실험적)

Bun은 TypeScript를 직접 실행하기 위한 선택적 로컬 런타임입니다(bun run ..., bun --watch ...). 기본 패키지 관리자는 계속 pnpm이며, 완전히 지원되고 문서 도구에서 사용됩니다. Bun은 pnpm-lock.yaml을 사용할 수 없으며 이를 무시합니다.

설치

  • 의존성 설치

    sh
    bun install

    bun.lock / bun.lockb은 git에서 무시되므로 저장소에 불필요한 변경이 생기지 않습니다. 잠금 파일 쓰기를 완전히 건너뛰려면 다음을 실행하세요.

    sh
    bun install --no-save
  • 빌드 및 테스트

    sh
    bun run buildbun run vitest run
  • 수명 주기 스크립트

    Bun은 명시적으로 신뢰하도록 설정하지 않은 의존성 수명 주기 스크립트를 차단합니다. 이 저장소에서 일반적으로 차단되는 다음 스크립트는 필요하지 않습니다.

    • baileys preinstall: Node 주 버전이 20 이상인지 확인합니다(OpenClaw에는 Node 22.19+ 또는 23.11+가 필요하며, Node 24를 권장합니다).
    • protobufjs postinstall: 호환되지 않는 버전 체계에 대한 경고를 출력합니다(빌드 산출물 없음).

    이러한 스크립트가 필요한 런타임 문제가 발생하면 명시적으로 신뢰하도록 설정하세요.

    sh
    bun pm trust baileys protobufjs

    주의 사항

    일부 패키지 스크립트는 내부적으로 pnpm을 하드코딩합니다(예: check:docs, ui:*, protocol:check). bun run을 통해 실행해도 여전히 셸에서 pnpm을 호출하므로, 이러한 스크립트는 pnpm으로 직접 실행하세요.

    관련 문서

    Was this useful?
    On this page

    On this page