安装方式

Bun(实验性)

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

安装

  • 安装依赖

    bun install
    

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

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

    bun run build
    bun run vitest run
    
  • 生命周期脚本

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

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

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

    bun pm trust @whiskeysockets/baileys protobufjs
    

    注意事项

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

    相关内容