قنوات التطوير¶

آخر تحديث: 2026-01-21

يوفّر OpenClaw ثلاث قنوات تحديث:

• stable: وسم توزيع npm ‏latest.
• beta: وسم توزيع npm ‏beta (بُنى قيد الاختبار).
• dev: رأس متحرك لـ main (git). وسم توزيع npm: ‏dev (عند النشر).

نقوم بشحن البُنى إلى beta، ثم نختبرها، وبعدها نرقّي بُنية مُعتمَدة إلى latest من دون تغيير رقم الإصدار — إذ تُعدّ وسوم التوزيع المصدرَ المرجعي لتثبيتات npm.

التبديل بين القنوات¶

التحقق عبر Git:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev

• stable/beta يقومان بالتحقق من أحدث وسم مطابق (وغالبًا يكون الوسم نفسه).
• dev ينتقل إلى main ويُعيد الدمج مع المستودع الأعلى.

التثبيت العام عبر npm/pnpm:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev

يتم التحديث عبر وسم توزيع npm المقابل (latest، beta، dev).

عندما تقوم صراحةً بالتبديل بين القنوات باستخدام --channel، يقوم OpenClaw أيضًا بمحاذاة طريقة التثبيت:

• dev يضمن وجود تحقق عبر git (الافتراضي ~/openclaw، ويمكن التجاوز باستخدام OPENCLAW_GIT_DIR)، ويحدّثه، ثم يثبّت CLI العام من ذلك التحقق.
• stable/beta يثبّت من npm باستخدام وسم التوزيع المطابق.

نصيحة: إذا أردت استخدام stable وdev بالتوازي، فاحتفِظ بنسختين مستنسختين ووجّه الـ Gateway إلى النسخة المستقرة.

الإضافات والقنوات¶

عند التبديل بين القنوات باستخدام openclaw update، يقوم OpenClaw أيضًا بمزامنة مصادر الإضافات:

• dev يفضّل الإضافات المضمّنة من تحقق git.
• stable وbeta يعيدان تثبيت حِزم الإضافات المثبّتة عبر npm.

أفضل ممارسات الوسم¶

• ضع وسومًا للإصدارات التي تريد أن تصل إليها تحققات git (vYYYY.M.D أو vYYYY.M.D-<patch>).
• حافظ على عدم قابلية الوسوم للتغيير: لا تنقل وسمًا ولا تعِد استخدامه.
• تظل وسوم توزيع npm هي المصدر المرجعي لتثبيتات npm:
• latest → stable
• beta → بُنية مرشّحة
• dev → لقطة من main (اختياري)

توفّر تطبيق macOS¶

قد لا تتضمن بُنى beta وdev إصدار تطبيق macOS. لا مشكلة في ذلك:

• يمكن مع ذلك نشر وسم git ووسم توزيع npm.
• أشر بوضوح إلى «لا يوجد إصدار macOS لهذه النسخة التجريبية» في ملاحظات الإصدار أو سجل التغييرات.