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

​
التحديث

حافظ على تحديث OpenClaw.

​
موصى به: openclaw update

أسرع طريقة للتحديث. يكتشف نوع التثبيت لديك (npm أو git)، ويجلب أحدث إصدار، ويشغّل openclaw doctor، ثم يعيد تشغيل البوابة. 
openclaw update
للتبديل بين القنوات أو استهداف إصدار محدد: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # معاينة بدون تطبيق
يفضّل --channel beta قناة beta، لكن وقت التشغيل يعود إلى stable/latest عندما تكون علامة beta مفقودة أو أقدم من أحدث إصدار مستقر. استخدم --tag beta إذا كنت تريد npm beta dist-tag الخام لتحديث حزمة لمرة واحدة. راجع قنوات التطوير لمعرفة دلالات القنوات.

​
بديل: أعد تشغيل المثبّت

curl -fsSL https://openclaw.ai/install.sh | bash
أضف --no-onboard لتخطي الإعداد الأولي. بالنسبة إلى التثبيتات من المصدر، مرّر --install-method git --no-onboard.

​
بديل: npm أو pnpm أو bun يدويًا

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
أداة التحديث التلقائي

أداة التحديث التلقائي متوقفة افتراضيًا. فعّلها في ~/.openclaw/openclaw.json: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
القناةالسلوك
stableينتظر stableDelayHours، ثم يطبّق مع تذبذب حتمي عبر stableJitterHours (نشر موزع).
betaيتحقق كل betaCheckIntervalHours (الافتراضي: كل ساعة) ويطبّق فورًا.
devلا يوجد تطبيق تلقائي. استخدم openclaw update يدويًا.
تسجل البوابة أيضًا تلميح تحديث عند بدء التشغيل (يمكن تعطيله عبر update.checkOnStart: false).

​
بعد التحديث

1
تشغيل doctor
2
openclaw doctor
3
يُرحّل الإعدادات، ويدقق سياسات الرسائل المباشرة، ويفحص سلامة البوابة. التفاصيل: Doctor
4
إعادة تشغيل البوابة
5
openclaw gateway restart
6
التحقق
7
openclaw health

​
التراجع

​
تثبيت إصدار محدد (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
نصيحة: يعرض npm view openclaw version الإصدار المنشور الحالي.

​
تثبيت commit محدد (المصدر)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
للعودة إلى الأحدث: git checkout main && git pull.

​
إذا كنت عالقًا

  • شغّل openclaw doctor مرة أخرى واقرأ المخرجات بعناية.
  • بالنسبة إلى openclaw update --channel dev في checkouts المصدر، يقوم برنامج التحديث بتهيئة pnpm تلقائيًا عند الحاجة. إذا رأيت خطأ في تهيئة pnpm/corepack، فثبّت pnpm يدويًا (أو أعد تفعيل corepack) ثم أعد تشغيل التحديث.
  • تحقق من: استكشاف الأخطاء وإصلاحها
  • اسأل في Discord: https://discord.gg/clawd

​
ذو صلة