> ## 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 (експериментально)

<Warning>
  Bun **не рекомендовано для середовища виконання Gateway** (відомі проблеми з WhatsApp і Telegram). Використовуйте Node для production.
</Warning>

Bun — це необов’язкове локальне середовище виконання для прямого запуску TypeScript (`bun run ...`, `bun --watch ...`). Менеджером пакетів за замовчуванням лишається `pnpm`, який повністю підтримується й використовується інструментами документації. Bun не може використовувати `pnpm-lock.yaml` і ігноруватиме його.

## Встановлення

<Steps>
  <Step title="Встановіть залежності">
    ```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun install
    ```

    `bun.lock` / `bun.lockb` додані до gitignore, тому зайвих змін у репозиторії не буде. Щоб повністю пропустити запис lock-файлів:

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

  <Step title="Зберіть і протестуйте">
    ```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun run build
    bun run vitest run
    ```
  </Step>
</Steps>

## Скрипти життєвого циклу

Bun блокує скрипти життєвого циклу залежностей, якщо їм явно не довірено. Для цього репозиторію скрипти, які зазвичай блокуються, не потрібні:

* `baileys` `preinstall` -- перевіряє, що основна версія Node >= 20 (OpenClaw за замовчуванням використовує Node 24 і досі підтримує Node 22 LTS, наразі `22.19+`)
* `protobufjs` `postinstall` -- виводить попередження про несумісні схеми версій (без артефактів збірки)

Якщо ви зіткнетеся з проблемою під час виконання, яка потребує цих скриптів, явно надайте їм довіру:

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

## Застереження

Деякі скрипти досі жорстко прив’язані до pnpm (наприклад, `check:docs`, `ui:*`, `protocol:check`). Поки що запускайте їх через pnpm.

## Пов’язане

* [Огляд встановлення](/uk/install)
* [Node.js](/uk/install/node)
* [Оновлення](/uk/install/updating)