Chuyển đến nội dung chính
Bun không được khuyến nghị cho runtime Gateway (các vấn đề đã biết với WhatsApp và Telegram). Dùng Node cho môi trường production.
Bun là runtime cục bộ tùy chọn để chạy TypeScript trực tiếp (bun run ..., bun --watch ...). Trình quản lý gói mặc định vẫn là pnpm, được hỗ trợ đầy đủ và được công cụ tài liệu sử dụng. Bun không thể dùng pnpm-lock.yaml và sẽ bỏ qua tệp này.

Cài đặt

1

Cài đặt phụ thuộc

bun install
bun.lock / bun.lockb đã được gitignore, nên sẽ không gây thay đổi trong repo. Để bỏ qua hoàn toàn việc ghi lockfile:
bun install --no-save
2

Build và kiểm thử

bun run build
bun run vitest run

Script vòng đời

Bun chặn các script vòng đời của phụ thuộc trừ khi được tin cậy rõ ràng. Với repo này, các script thường bị chặn không bắt buộc:
  • baileys preinstall — kiểm tra phiên bản chính của Node >= 20 (OpenClaw mặc định dùng Node 24 và vẫn hỗ trợ Node 22 LTS, hiện là 22.19+)
  • protobufjs postinstall — phát cảnh báo về quy ước phiên bản không tương thích (không có artifact build)
Nếu bạn gặp vấn đề runtime yêu cầu các script này, hãy tin cậy chúng rõ ràng:
bun pm trust baileys protobufjs

Lưu ý

Một số script vẫn hardcode pnpm (ví dụ check:docs, ui:*, protocol:check). Hiện tại hãy chạy các script đó qua pnpm.

Liên quan