Bun（實驗性）

Bun 不建議用於 Gateway 執行階段（已知 WhatsApp 和 Telegram 有問題）。生產環境請使用 Node。

Bun 是選用的本機執行階段，可直接執行 TypeScript（bun run ...、bun --watch ...）。預設套件管理器仍是 pnpm，它受到完整支援，也用於文件工具。Bun 無法使用 pnpm-lock.yaml，並會忽略它。

安裝

安裝依賴

bun install

bun.lock / bun.lockb 已加入 gitignore，因此不會造成 repo 變動。若要完全略過寫入 lockfile：

bun install --no-save

建置與測試

bun run build
bun run vitest run

Bun 會封鎖依賴的生命週期腳本，除非明確信任。對此 repo 而言，常見被封鎖的腳本並非必要：

@whiskeysockets/baileys preinstall — 檢查 Node 主要版本 >= 20（OpenClaw 預設使用 Node 24，且仍支援 Node 22 LTS，目前為 22.14+）
protobufjs postinstall — 發出不相容版本配置的警告（沒有建置產物）

如果遇到需要這些腳本的執行階段問題，請明確信任它們：

bun pm trust @whiskeysockets/baileys protobufjs

部分腳本仍硬編碼 pnpm（例如 docs:build、ui:*、protocol:check）。目前請透過 pnpm 執行這些腳本。