跳轉到主要內容
不建議將 Bun 用於閘道執行階段(WhatsApp 和 Telegram 有已知問題)。生產環境請使用節點。
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:檢查節點主版本 >= 20(OpenClaw 需要節點 22.19+ 或 23.11+,建議使用節點 24)
  • protobufjs postinstall:發出不相容版本配置的警告(沒有建置產物)
如果遇到需要這些指令碼的執行階段問題,請明確信任它們:
bun pm trust baileys protobufjs

注意事項

某些套件指令碼在內部硬編碼 pnpm(例如 check:docsui:*protocol:check)。透過 bun run 執行它們仍會 shell out 到 pnpm,因此請直接透過 pnpm 執行那些指令。

相關