跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Bun 不建议用于 Gateway 网关运行时（WhatsApp 和 Telegram 存在已知问题）。生产环境请使用 Node。
Bun 是可选的本地运行时，可用于直接运行 TypeScript（bun run ...、bun --watch ...）。默认包管理器仍然是 pnpm，它受到完全支持，并被文档工具使用。Bun 无法使用 pnpm-lock.yaml，并会忽略它。

​
安装

1

安装依赖

bun install
bun.lock / bun.lockb 已加入 gitignore，因此不会造成仓库变更。要完全跳过 lockfile 写入：
bun install --no-save
2

构建和测试

bun run build
bun run vitest run

​
生命周期脚本

Bun 会阻止依赖的生命周期脚本，除非显式信任。对于此仓库，常见被阻止的脚本并不是必需的：
  • baileys preinstall — 检查 Node 主版本 >= 20（OpenClaw 默认使用 Node 24，并且仍支持 Node 22 LTS，目前为 22.16+）
  • protobufjs postinstall — 输出关于不兼容版本方案的警告（无构建产物）
如果遇到需要这些脚本的运行时问题，请显式信任它们： 
bun pm trust baileys protobufjs

​
注意事项

有些脚本目前仍硬编码 pnpm（例如 docs:build、ui:*、protocol:check）。暂时请通过 pnpm 运行这些脚本。

​
相关