使用 Bun 运行 OpenClaw：安装与使用指南
在不少开发者的工具箱里，Bun已经逐渐成为一个热门的 JavaScript 运行时。它以启动速度快、内置打包工具和测试框架而受到关注。不过，在一些项目中，Bun 仍然处在“可选但不完全替代”的阶段。
家兴网络结合 OpenClaw 项目的实际情况，整理一份 使用 Bun 运行项目的安装与使用指南，适合希望尝试 Bun 的开发者参考。
一、Bun 运行方式说明
在该项目中，Bun 的定位是 可选运行时，主要用于本地开发环境运行 TypeScript，例如：
bun run ...bun --watch ...
需要注意的是：
pnpm 仍然是默认的构建工具
某些文档或工具脚本仍然依赖 pnpm
Bun 不会使用
pnpm-lock.yaml，并会忽略该文件
因此可以理解为：
| 工具 | 角色 |
|---|---|
| Bun | 本地运行 TypeScript |
| pnpm | 默认构建和脚本工具 |
如果你的目标是保持与官方流程一致，建议 继续保留 pnpm 工作流。
二、是否适合使用 Bun
在尝试之前，先确认你的使用场景。
适合
本地开发
测试 Bun 运行 TypeScript
想体验更快的开发启动速度
不适合
生产环境部署
Gateway 网关运行
WhatsApp / Telegram 集成场景
在这些场景中，官方仍然建议 使用 Node.js 运行环境，否则可能遇到兼容问题。
三、安装依赖
默认安装方式：
bun install
需要注意的一点是：
bun.lock或bun.lockb文件默认被.gitignore忽略因此不会对仓库产生变更
如果你希望 完全不写入锁文件，可以使用：
bun install --no-save
这种方式通常适用于临时测试环境或快速试运行。
四、使用 Bun 构建和测试
安装依赖完成后，可以直接使用 Bun 运行常见开发任务。
构建项目
bun run build
运行测试
bun run vitest run
对于大多数开发任务，Bun 可以直接执行 TypeScript，而不需要额外编译步骤，这也是它被不少开发者关注的原因之一。
五、Bun 生命周期脚本限制
Bun 在默认情况下会 阻止依赖包的生命周期脚本执行。
这样做的目的是提升安全性，避免安装阶段执行未知脚本。
在该项目中，常见被阻止的脚本包括：
1）@whiskeysockets/baileys
preinstall 脚本仅用于检查 Node 版本是否大于等于 20。
2）protobufjs
postinstall 脚本主要用于输出兼容性警告，并不会生成构建产物。
因此在多数情况下，这些脚本 即使被阻止也不会影响项目运行。
如果在某些情况下确实需要这些脚本，可以手动信任它们：
bun pm trust @whiskeysockets/baileys protobufjs
六、需要注意的脚本兼容问题
目前项目中仍然存在部分 硬编码 pnpm 的脚本，例如：
docs:buildui:*protocol:check
如果需要运行这些脚本，建议直接使用 pnpm，例如：
pnpm run docs:build
因此在当前阶段，Bun 更像是开发运行时补充，而不是完全替代 pnpm 的工具。
七、总结
如果你想体验 Bun 的开发效率，可以在本地环境尝试使用它运行项目。整体来说，它的优势主要体现在：
启动速度较快
原生支持 TypeScript
内置测试与构建工具
但在当前阶段，仍需要注意以下几点：
生产环境建议继续使用 Node.js
Gateway（如 WhatsApp / Telegram）不建议使用 Bun
部分脚本仍需通过 pnpm 运行
对于开发者来说，一个比较稳妥的策略是：
开发阶段使用 Bun，提高效率；构建与部署阶段继续使用 Node + pnpm。
这样既能体验新工具的优势，也不会影响项目的稳定性。
