الانتقال إلى المحتوى الرئيسي

​
Bun (تجريبي)

لا يُنصح باستخدام Bun لوقت تشغيل gateway (توجد مشكلات معروفة مع WhatsApp وTelegram). استخدم Node في الإنتاج.
Bun هو وقت تشغيل محلي اختياري لتشغيل TypeScript مباشرةً (bun run ..., bun --watch ...). يظل مدير الحزم الافتراضي هو pnpm، وهو مدعوم بالكامل ويُستخدم بواسطة أدوات الوثائق. لا يمكن لـ Bun استخدام pnpm-lock.yaml وسيتجاهله.

​
التثبيت

1

تثبيت التبعيات

bun install
يتم تجاهل bun.lock / bun.lockb في git، لذلك لا يحدث أي تشويش في المستودع. ولتخطي كتابة lockfile بالكامل:
bun install --no-save
2

البناء والاختبار

bun run build
bun run vitest run

​
Lifecycle Scripts

يمنع Bun lifecycle scripts الخاصة بالتبعيات ما لم تُوثَّق صراحةً. بالنسبة إلى هذا المستودع، لا تكون scripts المحجوبة الشائعة مطلوبة:
  • ‏@whiskeysockets/baileys ‏preinstall — تتحقق من أن إصدار Node الرئيسي >= 20 (يستخدم OpenClaw افتراضيًا Node 24 وما زال يدعم Node 22 LTS، حاليًا 22.14+)
  • ‏protobufjs ‏postinstall — تُصدر تحذيرات حول مخططات الإصدارات غير المتوافقة (من دون مخرجات build)
إذا واجهت مشكلة وقت تشغيل تتطلب هذه scripts، فوثّقها صراحةً: 
bun pm trust @whiskeysockets/baileys protobufjs

​
محاذير

لا تزال بعض scripts تُثبّت pnpm صراحةً (مثل docs:build, ui:*, protocol:check). شغّلها عبر pnpm في الوقت الحالي.