安装方式

Bun

Bun 仍可用作可选的依赖安装工具和软件包脚本运行工具。默认软件包管理器仍为 pnpm，它受到完全支持，并由文档工具使用。Bun 无法使用 pnpm-lock.yaml，并会将其忽略。

安装

bun install

bun.lock / bun.lockb 已被 git 忽略，因此不会导致仓库变更。要完全跳过锁文件写入：

bun install --no-save

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：输出有关不兼容版本方案的警告（不生成构建产物）

如果遇到需要这些脚本的运行时问题，请明确将它们设为受信任：

bun pm trust baileys protobufjs

某些软件包脚本在内部硬编码了 pnpm（例如 check:docs、ui:*、protocol:check）。通过 bun run 运行它们时，仍会通过 shell 调用 pnpm，因此只需直接通过 pnpm 运行这些脚本。