أوامر CLI

update

قم بتحديث OpenClaw بأمان والتبديل بين قنوات الإصدار المستقر/بيتا/التطوير. إذا قمت بالتثبيت عبر npm/pnpm (تثبيت عام، بدون بيانات تعريف git)، فإن التحديثات تتم عبر سير عمل مدير الحزم في التحديث.

الاستخدام

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --dry-run
openclaw update --no-restart
openclaw update --json
openclaw --update

الخيارات

  • --no-restart: تخطي إعادة تشغيل خدمة البوابة بعد التحديث الناجح.
  • --channel <stable|beta|dev>: تعيين قناة التحديث (git + npm؛ يتم حفظها في الإعدادات).
  • --tag <dist-tag|version>: تجاوز علامة التوزيع npm أو رقم الإصدار لهذا التحديث فقط.
  • --dry-run: معاينة إجراءات التحديث المخطط لها (قناة/علامة/هدف/سير عمل إعادة التشغيل) دون كتابة الإعدادات أو التثبيت أو مزامنة الإضافات أو إعادة التشغيل.
  • --json: طباعة JSON من نوع UpdateRunResult قابلة للقراءة الآلية.
  • --timeout <seconds>: مهلة لكل خطوة (القيمة الافتراضية هي 1200 ثانية).

ملاحظة: تتطلب عملية الرجوع إلى إصدار أقدم تأكيدًا لأن الإصدارات الأقدم قد تتسبب في تلف التكوين.

update status

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

openclaw update status
openclaw update status --json
openclaw update status --timeout 10

الخيارات:

  • --json: طباعة JSON للحالة قابلة للقراءة الآلية.
  • --timeout <seconds>: مهلة للفحوصات (القيمة الافتراضية هي 3 ثوانٍ).

update wizard

سير عمل تفاعلي لاختيار قناة تحديث وتأكيد ما إذا كان سيتم إعادة تشغيل البوابة بعد التحديث (الافتراضي هو إعادة التشغيل). إذا قمت بتحديد dev بدون نسخة git، فإنه يعرض إنشاء واحدة.

ما يفعله الأمر

عند التبديل بين القنوات بشكل صريح (--channel ...)، يحافظ OpenClaw أيضًا على محاذاة طريقة التثبيت:

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

يعيد مُحدِّث نواة البوابة التلقائي (عند تمكينه عبر الإعدادات) استخدام مسار التحديث نفسه.

سير عمل نسخة Git

القنوات:

  • stable: استخراج أحدث علامة غير بيتا، ثم البناء + الفحص.
  • beta: استخراج أحدث علامة -beta، ثم البناء + الفحص.
  • dev: استخراج الفرع main، ثم الجلب وإعادة التأسيس.

على مستوى عالٍ:

  1. يتطلب شجرة عمل نظيفة (بدون تغييرات غير مرفوعة).
  2. التبديل إلى القناة المحددة (علامة أو فرع).
  3. جلب التحديثات من المصدر الرئيسي (للتطوير فقط).
  4. للتطوير فقط: فحص مسبق للترميز + بناء TypeScript في شجرة عمل مؤقتة؛ إذا فشلت النقطة الأخيرة، يتم التراجع حتى 10 عمليات إيداع للعثور على أحدث بناء نظيف.
  5. إعادة التأسيس على عملية الإيداع المحددة (للتطوير فقط).
  6. تثبيت التبعيات (يفضل pnpm؛ مع الاحتياط npm).
  7. بناء + بناء واجهة التحكم.
  8. تشغيل openclaw doctor كفحص نهائي "لتحديث آمن".
  9. مزامنة الإضافات مع القناة النشطة (يستخدم التطوير الإضافات المضمنة؛ يستخدم المستقر/بيتا npm) وتحديث الإضافات المثبتة عبر npm.

الاختصار --update

openclaw --update يعيد كتابته إلى openclaw update (مفيد للنصوص البرمجية للأصداف وبرامج التشغيل).

انظر أيضًا

uninstallvoicecall