Bun

用于安装和运行包脚本的 Bun 工作流；运行时需要 Node

Bun 无法运行 OpenClaw CLI 或 Gateway 网关，因为它不提供所需的 node:sqlite API。请为所有 OpenClaw 运行时命令安装受支持的 Node 版本。

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

安装

安装依赖

bun install

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

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 运行它们时，仍会调用 shell 来执行 pnpm，因此直接通过 pnpm 运行这些脚本即可。