Containers

Bun (experimental)

Bun é um ambiente de execução local opcional para executar TypeScript diretamente (bun run ..., bun --watch ...). O gerenciador de pacotes padrão continua sendo o pnpm, que tem suporte completo e é usado pelas ferramentas de documentação. O Bun não pode usar o 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 evitar completamente a gravação do arquivo de lock:

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

    sh
    bun run buildbun run vitest run
  • Scripts de ciclo de vida

    O Bun bloqueia scripts de ciclo de vida das 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 exige Node 22.19+ ou 23.11+, sendo Node 24 recomendado)
    • protobufjs postinstall: emite avisos sobre esquemas de versão incompatíveis (sem artefatos de compilação)

    Se você encontrar um problema de execução que exija esses scripts, marque-os explicitamente como confiáveis:

    sh
    bun pm trust baileys protobufjs

    Ressalvas

    Alguns scripts de pacote usam pnpm de forma fixa internamente (por exemplo, check:docs, ui:*, protocol:check). Executá-los por meio de bun run ainda invoca o pnpm em um shell, portanto execute-os diretamente com pnpm.

    Relacionados

    Was this useful?
    On this page

    On this page