Vai al contenuto principale

​
Bun (Sperimentale)

Bun non è consigliato per il runtime del gateway (problemi noti con WhatsApp e Telegram). Usa Node in produzione.
Bun è un runtime locale facoltativo per eseguire direttamente TypeScript (bun run ..., bun --watch ...). Il gestore pacchetti predefinito resta pnpm, che è pienamente supportato e usato dalla tooling della documentazione. Bun non può usare pnpm-lock.yaml e lo ignorerà.

​
Installazione

1

Installa le dipendenze

bun install
bun.lock / bun.lockb sono ignorati da git, quindi non c’è churn nel repository. Per saltare completamente la scrittura del lockfile:
bun install --no-save
2

Build e test

bun run build
bun run vitest run

​
Script lifecycle

Bun blocca gli script lifecycle delle dipendenze a meno che non siano esplicitamente trusted. Per questo repository, gli script comunemente bloccati non sono necessari:
  • @whiskeysockets/baileys preinstall — controlla che la versione major di Node sia >= 20 (OpenClaw usa per impostazione predefinita Node 24 e continua a supportare Node 22 LTS, attualmente 22.14+)
  • protobufjs postinstall — emette avvisi su schemi di versione incompatibili (nessun artefatto di build)
Se riscontri un problema runtime che richiede questi script, considerali esplicitamente trusted: 
bun pm trust @whiskeysockets/baileys protobufjs

​
Limitazioni

Alcuni script continuano a usare pnpm in modo hardcoded (ad esempio docs:build, ui:*, protocol:check). Per ora eseguili tramite pnpm.