Bun 运行时（实验性）

Bun 是可选的本地运行时，可直接运行 TypeScript（bun run ...、bun --watch ...），适合追求最快本地开发循环的场景。

警告：Bun 不推荐用于 Gateway 生产运行时（WhatsApp 和 Telegram 存在已知问题）。生产环境请使用 Node。

默认包管理器仍是 pnpm

Bun 无法使用 pnpm-lock.yaml，会忽略它。文档工具链也使用 pnpm。

安装

bun install
# 跳过 lockfile 写入
bun install --no-save

构建与测试

bun run build
bun run vitest run

Lifecycle Scripts 问题

Bun 默认阻止依赖的 lifecycle scripts，常见被阻止的脚本：

• baileys preinstall — 检查 Node 版本（OpenClaw 默认 Node 24，支持 Node 22 LTS）
• protobufjs postinstall — 版本兼容性警告（无构建产物）

如需启用：

bun pm trust baileys protobufjs

注意事项

部分脚本仍硬编码 pnpm（如 docs:build、ui:*、protocol:check），这些需通过 pnpm 运行。

相关链接

• install-node — Node.js 安装
• install-updating — 更新 OpenClaw