> ## 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 を使用してください。
</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 されているため、リポジトリの差分は発生しません。lockfile の書き込みを完全にスキップするには:

    ```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 22.19+ または 23.11+ が必要で、Node 24 が推奨されます）
* `protobufjs` `postinstall`: 互換性のないバージョンスキームに関する警告を出力します（ビルド成果物はありません）

これらのスクリプトが必要なランタイム問題に遭遇した場合は、明示的に信頼してください:

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

## 注意点

一部のパッケージスクリプトは内部で `pnpm` をハードコードしています（例: `check:docs`、`ui:*`、`protocol:check`）。`bun run` 経由で実行しても `pnpm` をシェル経由で呼び出すため、それらは `pnpm` で直接実行してください。

## 関連

* [インストール概要](/ja-JP/install)
* [Node.js](/ja-JP/install/node)
* [更新](/ja-JP/install/updating)