OpenClaw أي إصدار تتبع، وكيف تقوم بالترقية
قام شياو تشو بتثبيت OpenClaw على أحد الخوادم الصغيرة في الشركة، وكان يعمل بشكل جيد ولم يلمسه لمدة شهر. وفي يوم ما، نشر أحدهم في المجموعة رسالة: "ظهرت ثغرة أمنية عالية الخطورة في OpenClaw، قم بالترقية فورًا." ففتح GitHub ووجد أنه تم إصدار عدة إصدارات خلال أسبوع واحد، بالإضافة إلى مسار يسمى extended-stable، فلم يعرف إلى أي إصدار يرقّي، وكيف يتراجع إذا فشلت الترقية.
يمضي هذا الدرس عبر الخطوات بالترتيب الواقعي:
- 1?
- 2?
- 3?
- 4?
- 5?
- 6?
اضغط عليها واحدة تلو الأخرى حسب الترتيب.
OpenClaw هناك أربع قنوات تحديث: stable وextended-stable وbeta وdev. يتبع معظم الناس قناة stable؛ أما من يريدون عناءً أقل وتشغيلًا طويل الأمد على الخوادم فيمكنهم اتباع extended-stable؛ وbeta وdev مخصصان لمن يريدون تجربة الميزات الجديدة وللمطورين. وعند صدور نشرة أمنية، قم بالترقية داخل قناتك إلى الإصدار المصحح المذكور في النشرة أو أحدث منه.
ماذا ستستطيع أن تفعل بعد هذا الدرس
- توضيح الفروق بين القنوات الأربع واختيار واحدة لأجهزتك
- قراءة نشرة أمنية من OpenClaw وتحديد ما إذا كنت متأثرًا بها
- استخدام
openclaw updateللتجربة المسبقة والترقية والتحقق، والتراجع عند الحاجة
التعامل أولًا مع هذه النشرة أمامك
2026-11-19، أصدرت OpenClaw نشرة عالية الخطورة برقم GHSA-pw3x-g8v8-fvj2 (CVSS 8.8). وهي تؤثر على الإصدار المرجعي لهذا الدرس 2026.10.9، لذا نضع الخلاصة هنا أولًا:
| الحقل في النشرة | المحتوى |
|---|---|
| العنوان | OpenClaw delegation could skip approval for restricted agents |
| المشكلة | عندما تمنع سياسة الأدوات تنفيذ الأوامر وكتابة الملفات، لا يزال أداة openclaw قادرة على كتابة إعدادات دائمة دون موافقة، مما يتيح للـ agent المقيد فتح تنفيذ أوامر على المضيف |
| الإصدارات المتأثرة | ≥ 2026.9.2 و < 2026.10.33؛ ≥ 2026.11.1 و < 2026.11.4 |
| إصدار الإصلاح | أول إصدار مصحح لقناة stable هو 2026.11.4؛ وعلى مستخدمي extended-stable الترقية إلى 2026.10.33 |
| التخفيف قبل الترقية | ضبط tools.exec.mode على ask ورفض تغييرات التفويض غير الموثوقة |
النص الأصلي للنشرة: https://github.com/openclaw/openclaw/security/advisories/GHSA-pw3x-g8v8-fvj2. جميع النشرات الأمنية لـ OpenClaw موجودة في صفحة Security → Advisories في المستودع: https://github.com/openclaw/openclaw/security/advisories.
ابحثنسختي الحالية هي……
انقر على واحد لترى.
توجد في النشرة جملة يسهل تفويتها: هذه الثغرة "لا تغيّر نموذج الثقة في OpenClaw"، وحجم التأثير يعتمد على إعداداتك، وعلى ما إذا كانت المدخلات منخفضة الثقة يمكنها الوصول إلى هذا المسار. بمعنى أن بوابة (Gateway) يستخدمها شخص واحد فقط ولا تتصل بقنوات خارجية تكون مخاطرها أقل، لكن يجب الترقية رغم ذلك.
- استخدمت
openclaw --versionللاطلاع على إصداري ومعرفة ما إذا كنت متأثرًا
ما الفرق بين القنوات الأربع
تعريف الوثائق الرسمية للقنوات الأربع:
| القناة | وسم npm المقابل | الوصف |
|---|---|---|
| stable | latest | موصى به لمعظم المستخدمين |
| extended-stable | extended-stable | النص الرسمي هو "trailing supported-month package channel"، أي خط إصدار يتأخر عن أحدث نسخة ويُصان شهريًا؛ يدعم التثبيت عبر الحزم فقط (npm وغيرها) ولا يدعم التثبيت عبر git؛ لا يمكن إجراء التثبيت إلا في المقدمة (foreground)؛ عند تفعيل update.checkOnStart يعرض إشعارات تحديث للقراءة فقط فقط، ولا يقوم بالتثبيت تلقائيًا أبدًا |
| beta | beta | يأخذ الأحدث رقم إصدار من بين beta و latest؛ لا تستبدل نسخة beta الأقدم نسخة stable الأحدث |
| dev | لا شيء (فرع main في git) | قد يحتوي على ميزات غير مكتملة أو تغييرات كاسحة، لا تستخدمه على Gateway في بيئة الإنتاج |
توضيح موقع extended-stable جاء بأوضح صورة في ملاحظات إصدار 2026.10.33: "gateway-only extended-stable release, which is our current equivalent to LTS". إنه OpenClaw نهاية شهر 10، مضافًا إليه إصلاحات أمنية حرجة وإصلاحات موثوقية وأداء ودعم نماذج جديدة. يُصدر Gateway فقط: حزمة npm الأساسية، والإضافات الرسمية المصاحبة لـ npm، وصورة Gateway على Docker، ولا يشمل تطبيق App الأصلي. أما أرقام الإصدارات، فيستخدم extended-stable أرقام التصحيح من 33 شهريًا وما فوق (مثل 2026.9.33 ~ 2026.9.37 و 2026.10.33)، بترقيم منفصل عن ترقيم stable.
اعتبارًا من 2026-11-20، أحدث إصدارات الخطوط الثلاثة:
| القناة | الإصدار | التاريخ |
|---|---|---|
| stable | 2026.11.6 | 2026-11-19 |
| extended-stable | 2026.10.33 | 2026-11-18 |
| beta | 2026.11.10-beta.1 | 2026-11-19 |
اختبر معرفتكثبّت شياو تشو الـ OpenClaw عبر npm على خادم، ويشغّل البوابة فقط، ولا يريد متابعة التغييرات كل أسبوع، لكنه لا يريد تفويت أي إصلاح أمني. أي قناة أنسب له؟
- اخترت القناة التي سأتبعها
الخطوة 1: تحقق من الإصدار والقناة الحاليين
لماذا: قبل الترقية يجب معرفة نقطة البداية، خاصة أي تثبيت يعمل عليه خدمة Gateway فعليًا.
openclaw --version
openclaw update statusيفترض أن ترى: الأمر الأول يطبع رقم إصدار CLI. والثاني يعرض القناة الحالية ومصدر تحديدها (الإعدادات، أو وسم git، أو فرع git، أو الإصدار المثبت، أو القيمة الافتراضية)، وطريقة التثبيت (عبر git أم عبر الحزم)، والإصدار الحالي، وما إذا كانت هناك تحديثات متاحة.
تذكّر أيضًا فحص ما قبل الترقية الرسمي: openclaw --version يعرض إصدار سطر الأوامر، بينما قد تشير خدمة Gateway إلى تثبيت آخر. تحقق مرة أخرى باستخدام openclaw status و openclaw gateway status --deep.
- أعرف إصداري وقناتي وطريقة تثبيتي
الخطوة 2: عند تعذر الترقية فورًا، طبّق تخفيفًا مؤقتًا أولًا
لماذا: التخفيف الذي تقترحه الإعلان هو جعل التنفيذ يمر عبر تأكيد يدوي، ليسدّ أكثر المسارات خطورة قبل الترقية.
في ~/.openclaw/openclaw.json:
{
tools: {
exec: { mode: "ask" },
},
}بعد التعديل أعد تشغيل Gateway. هذا مجرد تخفيف، ولا تزال التوصية الأولى في الإعلان هي الترقية.
- على الأجهزة التي لا يمكن ترقيتها مؤقتًا، ضبطت
tools.exec.modeعلىask
الخطوة 3: النسخ الاحتياطي، ثم التمرين المسبق
لماذا: تقول الوثائق الرسمية إن ما يحفظه openclaw update تلقائيًا هو مجرد نسخة من الإعدادات قبل الترقية، وليس الحالة الكاملة. كما أن التراجع عن الإصدار لا يلغي ترحيلات الإعدادات وقاعدة البيانات، فإن أردت حقًا العودة إلى الإصدار القديم فسبيلك نسخة احتياطية من ما قبل الترقية.
mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verifyيجب أن ترى: ظهور ملف أرشيف إضافي في دليل النسخ الاحتياطية. قد يحتوي الأرشيف على بيانات اعتماد وحالات القنوات، فيجب حمايته كما تحمي ~/.openclaw.
ثم قم بتشغيل تجربة مسبقة لترى ما ينوي فعله:
openclaw update --channel stable --dry-run
# 想跟 extended-stable 的改成:
openclaw update --channel extended-stable --dry-runيجب أن ترى: في التقرير القناة السارية، والإصدار المستهدف، والإجراءات المخطط تنفيذها، وما إذا كان التأكيد على التخفيض مطلوبًا. --dry-run لا يغيّر أي شيء.
- لدي نسخة احتياطية تم إنشاؤها باستخدام
--verify، وقد اطّلعت على نتائج التجربة المسبقة
الخطوة 4: الترقية والتحقق
لماذا: ينفّذ --channel الترقية، وبعد نجاح ترقية النواة يكتب اختيارك في update.channel من الإعدادات، فتصبح تشغيلات openclaw update اللاحقة تستخدم هذا المسار مباشرة.
openclaw update --channel stable
# 或
openclaw update --channel extended-stableيجب أن ترى: اكتمال الترقية. بالنسبة لخدمة Gateway المُدارة، بعد نجاح التبديل يُعاد تحميل الخدمة ويُفحص جهوزها؛ وإذا رُفض التبديل أو جرى التراجع بعد التحقق، تُستعادة الخدمة السابقة.
تحقق مرة أخرى:
openclaw --version
openclaw gateway status --deepيجب أن ترى: رقم الإصدار هو 2026.11.4 أو أحدث (stable)، أو 2026.10.33 (extended-stable).
بعض النقاط التي يجب الانتباه إليها:
تثبيتات git لا يمكنها استخدام extended-stable. سيبقى OpenClaw كما هو، لتتحول إلى التثبيت عبر الحزمة.
الانتقال من 2026.11.1 ~ 11.3 إلى extended-stable 2026.10.33 يُعد تخفيضًا بحسب رقم الإصدار، وسيظهر تأكيد التخفيض. لا يتراجع التخفيض عن الترحيلات التي حدثت بالفعل، وفي هذه الحالة يكون الترقية من stable إلى ما فوق 2026.11.4 أكثر أمانًا.
إذا أردت تثبيت إصدار معين مرة واحدة فقط دون تغيير القناة، استخدم
--tag، كما فيopenclaw update --tag 2026.4.1-beta.1في الوثائق الرسمية.--tagيعمل فقط مع التثبيت عبر حزمة npm، وتثبيتات git تتجاهله.الإصدار الذي يعرضه
openclaw --versionلم يعد ضمن النطاق المتأثر
الخطوة 5: التراجع عند حدوث مشاكل
لماذا: يتعارض الإصدار الجديد أحيانًا مع بيئتك. توصي الوثائق الرسمية بالتراجع باستخدام openclaw update بدلًا من الكتابة اليدوية عبر npm i -g، لأن الأخيرة لا تحتفظ بالحزمة السابقة ولا تشغّل إجراء الاستعادة.
openclaw update --tag <已知可用的版本> --dry-run
openclaw update --tag <已知可用的版本>يفحص المحدّث التوافق، ويطلب منك تأكيد التخفيض. إذا كانت القناة المحفوظة لديك هي extended-stable، فتقول الوثائق الرسمية إنه يجب إضافة --channel stable لتحديد الإصدار الدقيق.
يجب أن ترى: إعادة تشغيل الخدمة، وعودة الإصدار قيد التشغيل إلى الإصدار الذي حددته. إذا لم يستطع الإصدار القديم قراءة الحالة الحالية، سيرفض المحدّث، وعندها يجب استخدام النسخة الاحتياطية من الخطوة 3 مع الإصدار القديم المقابل للاستعادة. لا تتجاوز رفضًا من نوع "إعدادات أو قاعدة بيانات كتبها الإصدار الجديد".
وهناك خيارا احتياط أخيران:
- عند فشل التحقق من الحزمة المنشّطة حديثًا، يتراجع
openclaw updateتلقائيًا إلى الإصدار السابق عند استيفاء الشروط. بدءًا من 2026.11.5، يؤدي فشل تشغيل Doctor أو Gateway أيضًا إلى التراجع عن التحديث المنشّط. - إذا علقت الأمور، شغّل
openclaw triageعلى الجهاز الذي يعمل عليه Gateway، وسيسلّم معلومات التشخيص إلى وكيل البرمجة المحلي على ذلك الجهاز ليصلح الأمر لك.
عند التراجع لا تعد إلى الإصدارات المتأثرة
لأنه عند التراجع بسبب GHSA-pw3x يجب اختيار إصدار هدف هو 2026.11.4 أو أحدث أو 2026.10.33. العودة إلى 2026.10.9 تعني إعادة تثبيت الثغرة.
- سجّلت رقم إصدار "معروف أنه يعمل، وغير متأثر بالإعلان"
نقطة تحقق
- أستطيع ذكر فرقين بين stable و extended-stable (مثل وتيرة التحديثات، ومدى تضمين التطبيق الأصلي)
- أستطيع من إعلان واحد إيجاد الإصدارات المتأثرة، والإصدارات المصحَّحة، والتخفيف المؤقت
- تم تحديث Gateway لدي إلى 2026.11.4 أو أحدث أو 2026.10.33
- أعرف أنه قبل الترقية يجب أولًا
openclaw backup create --verify، ثم--dry-run
مفاهيم خاطئة شائعة
الظن بأن extended-stable يحدّث نفسه. لا يقوم أبدًا بالتثبيت تلقائيًا، وأقصى ما يفعله هو إظهار تنبيه عند فحص بدء التشغيل. من يتبع هذا المسار عليه مراجعة الإعلانات دوريًا بنفسه وتشغيل openclaw update يدويًا.
الظن بأن التخفيض يتراجع عن كل شيء. تنص الوثائق الرسمية صراحة على أن حزمة التخفيض لا تتراجع عن ترحيلات الإعدادات وقاعدة البيانات. عندما تكون الحالة قد رُحّلت إلى تنسيق لا يستطيع الإصدار القديم قراءته، فإن الطريقة الوحيدة المدعومة هي استعادة النسخة الاحتياطية التي سبقت الترقية.
تظن أن beta أحدث من stable لذا فهي أكثر أمانًا. إصدار beta هو إصدار مرشح، وإصلاحات الأمان تُدرج في stable وextended-stable. استخدم stable أو extended-stable في بيئات الإنتاج؛ أما dev فقد أوضحت الجهة المسؤولة رسميًا أنه لا ينبغي استخدامه على Gateway الإنتاجي.
القسم التالي
الأوامر وخيارات الإعداد الشائعة كلها مجمّعة فيمرجع سريع لأوامر وإعدادات CLI، أما التغييرات في كل إصدار فتجدها فيسجل التغييرات.