Pular para o conteúdo principal

​
Bun (Experimental)

Bun não é recomendado para o runtime do gateway (problemas conhecidos com WhatsApp e Telegram). Use Node em produção.
Bun é um runtime local opcional para executar TypeScript diretamente (bun run ..., bun --watch ...). O gerenciador de pacotes padrão continua sendo pnpm, que é totalmente compatível e usado pelas ferramentas de documentação. Bun não pode usar pnpm-lock.yaml e irá ignorá-lo.

​
Instalação

1

Instalar dependências

bun install
bun.lock / bun.lockb estão no gitignore, então não há mudanças desnecessárias no repositório. Para pular totalmente a gravação do lockfile:
bun install --no-save
2

Compilar e testar

bun run build
bun run vitest run

​
Scripts de ciclo de vida

Bun bloqueia scripts de ciclo de vida de dependências, a menos que sejam explicitamente confiáveis. Neste repositório, os scripts comumente bloqueados não são necessários:
  • @whiskeysockets/baileys preinstall — verifica se a versão major do Node é >= 20 (OpenClaw usa Node 24 por padrão e ainda oferece suporte ao Node 22 LTS, atualmente 22.14+)
  • protobufjs postinstall — emite avisos sobre esquemas de versão incompatíveis (sem artefatos de compilação)
Se você encontrar um problema de runtime que exija esses scripts, confie neles explicitamente: 
bun pm trust @whiskeysockets/baileys protobufjs

​
Limitações

Alguns scripts ainda usam pnpm de forma fixa (por exemplo, docs:build, ui:*, protocol:check). Por enquanto, execute esses scripts com pnpm.