Bun

Bun 無法執行 OpenClaw 命令列介面或閘道，因為它未提供必要的 node:sqlite API。請安裝支援的 Node 版本，以執行所有 OpenClaw 執行階段命令。

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

安裝

安裝相依套件

bun install

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

bun install --no-save

建置與測試

bun run build
bun run vitest run

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

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

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

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

bun pm trust baileys protobufjs

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