Containers

Bun

Bun 仍可作為選用的相依套件安裝工具和套件指令碼執行工具。預設套件管理器仍為 pnpm,其受到完整支援,並由文件工具使用。Bun 無法使用 pnpm-lock.yaml,且會忽略它。

安裝

  • 安裝相依套件

    sh
    bun install

    bun.lock / bun.lockb 已列入 gitignore,因此不會造成儲存庫變動。若要完全略過鎖定檔寫入:

    sh
    bun install --no-save
  • 建置與測試

    sh
    bun run buildbun run vitest run

    啟動 OpenClaw 本身的命令仍必須透過 Node 執行。

  • 生命週期指令碼

    除非明確信任,否則 Bun 會封鎖相依套件的生命週期指令碼。對此儲存庫而言,通常遭封鎖的指令碼並非必要:

    • baileys preinstall:檢查 Node 主要版本是否 >= 20(OpenClaw 需要 Node 22.22.3+、24.15+ 或 25.9+,建議使用 Node 24)
    • protobufjs postinstall:針對不相容的版本配置方式發出警告(不產生建置成品)

    如果遇到需要這些指令碼的執行階段問題,請明確信任它們:

    sh
    bun pm trust baileys protobufjs

    注意事項

    有些套件指令碼在內部將 pnpm 寫死(例如 check:docsui:*protocol:check)。透過 bun run 執行它們時,仍會啟動殼層並呼叫 pnpm,因此請直接透過 pnpm 執行這些指令碼。

    相關內容

    Was this useful?
    On this page

    On this page