> ## 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="Install dependencies">
    ```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
    bun install
    ```

    يتم تجاهل `bun.lock` / `bun.lockb` في git، لذلك لا يحدث أي تغيير غير ضروري في المستودع. لتخطي كتابة ملف القفل بالكامل:

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

  <Step title="Build and test">
    ```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 في الوقت الحالي.

## ذات صلة

* [نظرة عامة على التثبيت](/ar/install)
* [Node.js](/ar/install/node)
* [التحديث](/ar/install/updating)