安装方式

Bun(实验性)

Bun 是可选的本地运行时,可用于直接运行 TypeScript(bun run ...bun --watch ...)。默认包管理器仍然是 pnpm,它受到完全支持,并被文档工具使用。Bun 无法使用 pnpm-lock.yaml,并会忽略它。

安装

  • 安装依赖

    sh
    bun install

    bun.lock / bun.lockb 已加入 gitignore,因此不会造成仓库变更。要完全跳过 lockfile 写入:

    sh
    bun install --no-save
  • 构建和测试

    sh
    bun run buildbun run vitest run
  • 生命周期脚本

    Bun 会阻止依赖的生命周期脚本,除非显式信任。对于此仓库,常见被阻止的脚本并不是必需的:

    • baileys preinstall -- 检查 Node 主版本 >= 20(OpenClaw 默认使用 Node 24,并且仍支持 Node 22 LTS,目前为 22.16+
    • protobufjs postinstall -- 输出关于不兼容版本方案的警告(无构建产物)

    如果遇到需要这些脚本的运行时问题,请显式信任它们:

    sh
    bun pm trust baileys protobufjs

    注意事项

    有些脚本目前仍硬编码 pnpm(例如 docs:buildui:*protocol:check)。暂时请通过 pnpm 运行这些脚本。

    相关

    Was this useful?