Bun（实验性）

不建议将 Bun 用于 Gateway 网关运行时（已知会与 WhatsApp 和 Telegram 出现问题）。生产环境请使用 Node。

Bun 是一种可选的本地运行时，可用于直接运行 TypeScript（bun run ...、bun --watch ...）。默认的包管理器仍然是 pnpm，它受到完整支持，并被文档工具链使用。Bun 无法使用 pnpm-lock.yaml，并且会忽略它。

安装

安装依赖

bun install

bun.lock / bun.lockb 已被 gitignore 忽略，因此不会给仓库带来额外变更。如果你想完全跳过 lockfile 写入：

bun install --no-save

构建并测试

bun run build
bun run vitest run

除非被显式信任，否则 Bun 会阻止依赖项的生命周期脚本。对于这个仓库，常见被阻止的脚本并不是必需的：

@whiskeysockets/baileys preinstall — 检查 Node 主版本是否 >= 20（OpenClaw 默认使用 Node 24，并且仍然支持 Node 22 LTS，目前为 22.14+）
protobufjs postinstall — 发出关于版本方案不兼容的警告（不会生成构建产物）

如果你遇到了需要这些脚本才能解决的运行时问题，请显式信任它们：

bun pm trust @whiskeysockets/baileys protobufjs

有些脚本仍然将 pnpm 硬编码进去（例如 docs:build、ui:*、protocol:check）。目前请继续通过 pnpm 运行这些脚本。