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 執行時,仍會啟動 shell 來呼叫 pnpm,因此直接透過 pnpm 執行這些指令碼即可。

    相關內容

    Was this useful?
    On this page

    On this page