> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bun (sperimentale)

<Warning>
  Bun è **sconsigliato per il runtime del Gateway** (problemi noti con WhatsApp e Telegram). Usa Node in produzione.
</Warning>

Bun è un runtime locale opzionale per eseguire TypeScript direttamente (`bun run ...`, `bun --watch ...`). Il package manager predefinito rimane `pnpm`, che è pienamente supportato e usato dagli strumenti della documentazione. Bun non può usare `pnpm-lock.yaml` e lo ignorerà.

## Installazione

<Steps>
  <Step title="Installa le dipendenze">
    ```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun install
    ```

    `bun.lock` / `bun.lockb` sono ignorati da git, quindi non generano variazioni nel repo. Per evitare del tutto la scrittura del lockfile:

    ```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun install --no-save
    ```
  </Step>

  <Step title="Compila ed esegui i test">
    ```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun run build
    bun run vitest run
    ```
  </Step>
</Steps>

## Script del ciclo di vita

Bun blocca gli script del ciclo di vita delle dipendenze a meno che non siano esplicitamente considerati attendibili. Per questo repo, gli script comunemente bloccati non sono necessari:

* `baileys` `preinstall` -- controlla che la versione major di Node sia >= 20 (OpenClaw usa per impostazione predefinita Node 24 e supporta ancora Node 22 LTS, attualmente `22.19+`)
* `protobufjs` `postinstall` -- emette avvisi su schemi di versione incompatibili (nessun artefatto di build)

Se riscontri un problema di runtime che richiede questi script, considerali attendibili esplicitamente:

```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
bun pm trust baileys protobufjs
```

## Avvertenze

Alcuni script codificano ancora `pnpm` in modo rigido (per esempio `check:docs`, `ui:*`, `protocol:check`). Per ora eseguili tramite pnpm.

## Correlati

* [Panoramica dell'installazione](/it/install)
* [Node.js](/it/install/node)
* [Aggiornamento](/it/install/updating)