> ## 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 (experimental)

<Warning>
  Bun **não é recomendado para o runtime do Gateway** (problemas conhecidos com WhatsApp e Telegram). Use Node em produção.
</Warning>

Bun é um runtime local opcional para executar TypeScript diretamente (`bun run ...`, `bun --watch ...`). O gerenciador de pacotes padrão continua sendo `pnpm`, que tem suporte completo e é usado pelas ferramentas da documentação. Bun não consegue usar `pnpm-lock.yaml` e vai ignorá-lo.

## Instalação

<Steps>
  <Step title="Instalar dependências">
    ```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun install
    ```

    `bun.lock` / `bun.lockb` estão no gitignore, então não há alterações no repo. Para ignorar totalmente gravações de lockfile:

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

  <Step title="Compilar e testar">
    ```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun run build
    bun run vitest run
    ```
  </Step>
</Steps>

## Scripts de ciclo de vida

Bun bloqueia scripts de ciclo de vida de dependências, a menos que eles sejam explicitamente confiáveis. Para este repo, os scripts comumente bloqueados não são necessários:

* `baileys` `preinstall` -- verifica se a versão principal do Node é >= 20 (OpenClaw usa Node 24 por padrão e ainda oferece suporte ao Node 22 LTS, atualmente `22.19+`)
* `protobufjs` `postinstall` -- emite avisos sobre esquemas de versão incompatíveis (sem artefatos de build)

Se você encontrar um problema de runtime que exija esses scripts, confie neles explicitamente:

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

## Ressalvas

Alguns scripts ainda têm pnpm fixo no código (por exemplo, `check:docs`, `ui:*`, `protocol:check`). Execute-os via pnpm por enquanto.

## Relacionados

* [Visão geral da instalação](/pt-BR/install)
* [Node.js](/pt-BR/install/node)
* [Atualização](/pt-BR/install/updating)