메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Bun은 Gateway 런타임에는 권장되지 않습니다(WhatsApp 및 Telegram과 관련된 알려진 문제가 있음). 프로덕션에서는 Node를 사용하세요.
Bun은 TypeScript를 직접 실행하기 위한 선택적 로컬 런타임입니다(bun run ..., bun --watch ...). 기본 패키지 관리자는 여전히 pnpm이며, 완전히 지원되고 문서 도구에서 사용됩니다. Bun은 pnpm-lock.yaml을 사용할 수 없으며 이를 무시합니다.

​
설치

1

의존성 설치

bun install
bun.lock / bun.lockb는 gitignore 처리되어 있으므로 저장소 변경이 발생하지 않습니다. 잠금 파일 쓰기를 완전히 건너뛰려면:
bun install --no-save
2

빌드 및 테스트

bun run build
bun run vitest run

​
라이프사이클 스크립트

Bun은 명시적으로 신뢰하도록 설정하지 않는 한 의존성 라이프사이클 스크립트를 차단합니다. 이 저장소에서 일반적으로 차단되는 스크립트는 필요하지 않습니다.
  • baileys preinstall — Node 주 버전이 20 이상인지 확인합니다(OpenClaw는 기본적으로 Node 24를 사용하며, 현재 22.16+인 Node 22 LTS도 계속 지원함).
  • protobufjs postinstall — 호환되지 않는 버전 체계에 대한 경고를 출력합니다(빌드 아티팩트 없음).
이 스크립트가 필요한 런타임 문제가 발생하면 명시적으로 신뢰하도록 설정하세요. 
bun pm trust baileys protobufjs

​
주의 사항

일부 스크립트는 아직 pnpm을 하드코딩합니다(예: docs:build, ui:*, protocol:check). 현재는 해당 스크립트를 pnpm으로 실행하세요.

​
관련 문서