Chuyển đến nội dung chính

Bun (Thử nghiệm)

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

Cài đặt

1

Cài đặt các phụ thuộc

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

Xây dựng và kiểm tra

bun run build
bun run vitest run

Script Vòng đời

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

Lưu ý

Một số script vẫn cứng nhắc sử dụng pnpm (ví dụ docs:build, ui:*, protocol:check). Hiện tại, hãy chạy chúng qua pnpm.
Last modified on March 22, 2026