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

# Bun (Experimental)

# Bun (experimental)

Objetivo: executar este repositório com **Bun** (opcional, não recomendado para WhatsApp/Telegram)
sem divergir dos fluxos de trabalho com pnpm.

⚠️ **Não recomendado para runtime do Gateway** (bugs no WhatsApp/Telegram). Use Node em produção.

## Status

* Bun é um runtime local opcional para executar TypeScript diretamente (`bun run …`, `bun --watch …`).
* `pnpm` é o padrão para builds e continua totalmente suportado (e usado por algumas ferramentas de docs).
* Bun não pode usar `pnpm-lock.yaml` e irá ignorá-lo.

## Instalar

Padrão:

```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
bun install
```

Nota: `bun.lock`/`bun.lockb` são ignorados pelo git, então não há churn no repositório de nenhuma forma. Se você quiser *nenhuma escrita de lockfile*:

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

## Compilar / Teste (Bun)

```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
bun run build
bun run vitest run
```

## Scripts de ciclo de vida do Bun (bloqueados por padrão)

O Bun pode bloquear scripts de ciclo de vida de dependências, a menos que sejam explicitamente confiáveis (`bun pm untrusted` / `bun pm trust`).
Para este repositório, os scripts comumente bloqueados não são necessários:

* `@whiskeysockets/baileys` `preinstall`: verifica Node major >= 20 (executamos Node 22+).
* `protobufjs` `postinstall`: emite avisos sobre esquemas de versão incompatíveis (sem artefatos de build).

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

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

## Ressalvas

* Alguns scripts ainda codificam pnpm (por exemplo, `docs:build`, `ui:*`, `protocol:check`). Execute esses via pnpm por enquanto.