Containers

Bun

O Bun continua podendo ser usado como instalador opcional de dependências e executor de scripts de pacote. O gerenciador de pacotes padrão continua sendo pnpm, que tem suporte completo e é usado pelas ferramentas de documentação. O Bun não pode usar pnpm-lock.yaml e o ignora.

Instalação

  • Instalar dependências

    sh
    bun install

    bun.lock / bun.lockb são ignorados pelo Git, portanto não há alterações desnecessárias no repositório. Para ignorar completamente a gravação de arquivos de lock:

    sh
    bun install --no-save
  • Compilar e testar

    sh
    bun run buildbun run vitest run

    Os comandos que iniciam o próprio OpenClaw ainda devem ser executados por meio do Node.

  • Scripts de ciclo de vida

    O Bun bloqueia scripts de ciclo de vida de dependências, a menos que sejam explicitamente considerados confiáveis. Neste repositório, os scripts normalmente bloqueados não são necessários:

    • baileys preinstall: verifica se a versão principal do Node é >= 20 (o OpenClaw requer Node 22.22.3+, 24.15+ ou 25.9+, sendo o Node 24 recomendado)
    • protobufjs postinstall: emite avisos sobre esquemas de versão incompatíveis (sem artefatos de compilação)

    Se ocorrer um problema de runtime que exija esses scripts, marque-os explicitamente como confiáveis:

    sh
    bun pm trust baileys protobufjs

    Ressalvas

    Alguns scripts de pacote incluem pnpm diretamente no código (por exemplo, check:docs, ui:*, protocol:check). Executá-los por meio de bun run ainda invoca pnpm em um shell, portanto basta executá-los diretamente por meio de pnpm.

    Conteúdo relacionado

    Was this useful?
    On this page

    On this page