> ## 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.

# قنوات الإصدار

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

* **stable**: وسم توزيع npm `latest`. موصى بها لمعظم المستخدمين.
* **beta**: وسم توزيع npm `beta` عندما يكون حاليًا؛ إذا كان beta مفقودًا أو أقدم من
  أحدث إصدار stable، يعود مسار التحديث إلى `latest`.
* **dev**: الرأس المتحرك لفرع `main` (git). وسم توزيع npm: `dev` (عند نشره).
  فرع `main` مخصص للتجريب والتطوير النشط. قد يحتوي على
  ميزات غير مكتملة أو تغييرات كاسرة. لا تستخدمه في بوابات الإنتاج.

عادةً ننشر بُنى stable إلى **beta** أولًا، ونختبرها هناك، ثم نشغّل
خطوة ترقية صريحة تنقل البنية المُدقّقة إلى `latest` دون
تغيير رقم الإصدار. يمكن للمشرفين أيضًا نشر إصدار stable
مباشرةً إلى `latest` عند الحاجة. وسوم التوزيع هي مصدر الحقيقة لتثبيتات npm.

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
```

يحفظ `--channel` اختيارك في الإعدادات (`update.channel`) ويوائم
طريقة التثبيت:

* **`stable`** (تثبيتات الحزمة): تُحدَّث عبر وسم توزيع npm `latest`.
* **`beta`** (تثبيتات الحزمة): تفضّل وسم توزيع npm `beta`، لكنها تعود إلى
  `latest` عندما يكون `beta` مفقودًا أو أقدم من وسم stable الحالي.
* **`stable`** (تثبيتات git): تنتقل إلى أحدث وسم git لإصدار stable، مع استبعاد
  وسوم إصدارات semver التمهيدية مثل `-alpha.N`، و`-beta.N`، و`-rc.N`، و`-dev.N`،
  و`-next.N`، و`-preview.N`، و`-canary.N`، و`-nightly.N`، ولواحق الإصدارات التمهيدية
  الأخرى.
* **`beta`** (تثبيتات git): تفضّل أحدث وسم git لإصدار beta، لكنها تعود إلى
  أحدث وسم git لإصدار stable عندما يكون beta مفقودًا أو أقدم.
* **`dev`**: تضمن وجود نسخة git محلية (افتراضيًا `~/openclaw`، أو
  `$OPENCLAW_HOME/openclaw` عندما يكون `OPENCLAW_HOME` معيّنًا؛ ويمكن التجاوز عبر
  `OPENCLAW_GIT_DIR`)، وتبدّل إلى `main`، وتعيد التأسيس فوق upstream، وتبني،
  وتثبّت CLI العام من تلك النسخة المحلية.

<Tip>
  إذا أردت تشغيل stable وdev بالتوازي، فاحتفظ بنسختين مستنسختين ووجّه بوابتك إلى نسخة stable.
</Tip>

## استهداف إصدار أو وسم لمرة واحدة

استخدم `--tag` لاستهداف وسم توزيع محدد، أو إصدار، أو مواصفة حزمة لتحديث واحد
**دون** تغيير قناتك المحفوظة:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Install a specific version
openclaw update --tag 2026.4.1-beta.1

# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta

# Switch to the moving GitHub main checkout
openclaw update --channel dev

# Install a specific npm package spec
openclaw update --tag openclaw@2026.4.1-beta.1

# Install from GitHub main once without persisting the channel
openclaw update --tag main
```

ملاحظات:

* ينطبق `--tag` على **تثبيتات الحزمة (npm) فقط**. تتجاهله تثبيتات git.
* لا يُحفَظ الوسم. يستخدم أمر `openclaw update` التالي القناة المضبوطة لديك
  كالمعتاد.
* في تثبيتات الحزمة، تُحضّر OpenClaw مواصفات مصدر GitHub/git مسبقًا في
  أرشيف tar مؤقت قبل تثبيت npm المرحلي. استخدم `--channel dev` أو
  `--install-method git --version main` عندما تريد نسخة `main` المتحركة
  كتثبيت دائم لديك.
* حماية الرجوع إلى إصدار أقدم: إذا كان الإصدار الهدف أقدم من إصدارك الحالي،
  تطلب OpenClaw التأكيد (يمكن التخطي باستخدام `--yes`).
* يختلف `--channel beta` عن `--tag beta`: يمكن لمسار القناة الرجوع إلى
  stable/latest عندما يكون beta مفقودًا أو أقدم، بينما يستهدف `--tag beta`
  وسم التوزيع الخام `beta` لذلك التشغيل الواحد.

## تشغيل تجريبي

عاين ما سيفعله `openclaw update` دون إجراء تغييرات:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json
```

يعرض التشغيل التجريبي القناة الفعلية، والإصدار الهدف، والإجراءات المخططة، وما إذا
كان سيلزم تأكيد الرجوع إلى إصدار أقدم.

## Plugins والقنوات

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

* تفضّل `dev` حِزم Plugins المضمّنة من نسخة git المحلية.
* تستعيد `stable` و`beta` حزم Plugin المثبّتة عبر npm.
* تُحدَّث Plugins المثبّتة عبر npm بعد اكتمال تحديث النواة.

## التحقق من الحالة الحالية

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw update status
```

يعرض القناة النشطة، ونوع التثبيت (git أو حزمة)، والإصدار الحالي،
والمصدر (الإعدادات، أو وسم git، أو فرع git، أو الافتراضي).

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

* ضع وسومًا للإصدارات التي تريد أن تصل إليها نسخ git المحلية (`vYYYY.M.PATCH` لإصدار stable،
  و`vYYYY.M.PATCH-beta.N` لإصدار beta؛ لواحق إصدارات semver التمهيدية المسماة مثل
  `-alpha.N`، و`-rc.N`، و`-next.N` ليست أهداف stable).
* لا تزال وسوم stable الرقمية القديمة مثل `vYYYY.M.PATCH-1` و`v1.0.1-1`
  معروفة كوسوم git لإصدارات stable من أجل التوافق.
* يُعرَف `vYYYY.M.PATCH.beta.N` أيضًا من أجل التوافق، لكن يُفضَّل `-beta.N`.
* أبقِ الوسوم غير قابلة للتغيير: لا تنقل وسمًا أو تعيد استخدامه أبدًا.
* تبقى وسوم توزيع npm مصدر الحقيقة لتثبيتات npm:
  * `latest` -> stable
  * `beta` -> بناء مرشح أو بناء stable يبدأ عبر beta
  * `dev` -> لقطة main (اختياري)

## توفر تطبيق macOS

قد **لا** تتضمن بُنى beta وdev إصدار تطبيق macOS. هذا مقبول:

* لا يزال من الممكن نشر وسم git ووسم توزيع npm.
* اذكر "لا توجد بنية macOS لهذا الإصدار beta" في ملاحظات الإصدار أو سجل التغييرات.

## ذات صلة

* [التحديث](/ar/install/updating)
* [تفاصيل المثبّت الداخلية](/ar/install/installer)