---
read_when:
    - Вам потрібен найшвидший локальний цикл розробки (bun + watch)
    - Ви зіткнулися з проблемами встановлення Bun, патчів або скриптів життєвого циклу
summary: 'Робочий процес Bun (експериментальний): встановлення та підводні камені порівняно з pnpm'
title: Bun (експериментально)
x-i18n:
    generated_at: "2026-05-11T20:42:08Z"
    model: gpt-5.5
    provider: openai
    source_hash: d97a7da26520d66e6033065c50d6490c869ace3d5f0b25aafcd196074cf7df7c
    source_path: install/bun.md
    workflow: 16
---

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

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

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

<Steps>
  <Step title="Встановіть залежності">
    ```sh
    bun install
    ```

    `bun.lock` / `bun.lockb` ігноруються Git, тому в репозиторії не виникає зайвих змін. Щоб повністю пропустити записування lockfile:

    ```sh
    bun install --no-save
    ```

  </Step>
  <Step title="Зберіть і протестуйте">
    ```sh
    bun run build
    bun run vitest run
    ```
  </Step>
</Steps>

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

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

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

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

```sh
bun pm trust baileys protobufjs
```

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

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

## Пов’язане

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