جارٍ التحديث

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

موصى به: openclaw update

أسرع طريقة للتحديث. يكتشف نوع التثبيت لديك (npm أو git)، ويجلب أحدث إصدار، ويشغّل openclaw doctor، ويعيد تشغيل Gateway.

openclaw update

للتبديل بين القنوات أو استهداف إصدار محدد:

openclaw update --channel betaopenclaw update --channel devopenclaw update --dry-run   # preview without applying

لا يقبل openclaw update الخيار --verbose. لتشخيصات التحديث، استخدم --dry-run لمعاينة الإجراءات المخطط لها، أو --json للحصول على نتائج منظمة، أو openclaw update status --json لفحص حالة القناة والتوفر. يملك المثبّت علم --verbose خاصا به، لكن هذا العلم ليس جزءا من openclaw update.

يفضّل --channel beta الإصدار التجريبي beta، لكن وقت التشغيل يعود إلى stable/latest عندما تكون وسم beta مفقودا أو أقدم من أحدث إصدار stable. استخدم --tag beta إذا كنت تريد dist-tag الخام الخاص بـ npm beta لتحديث حزمة لمرة واحدة.

استخدم --channel dev للحصول على checkout دائم ومتحرك لفرع GitHub main. لتحديثات الحزم، يُطابق --tag main إلى github:openclaw/openclaw#main لتشغيل واحد، وتُحزم مواصفات مصدر GitHub/git في tarball مؤقت قبل تنفيذ تثبيت npm المرحلي.

بالنسبة إلى Plugins المُدارة، يكون الرجوع الاحتياطي لقناة beta تحذيرا: لا يزال تحديث core قادرا على النجاح بينما تستخدم Plugin إصدارها المسجل الافتراضي/الأحدث لأنه لا يتوفر إصدار beta للـ Plugin.

راجع قنوات التطوير لمعاني القنوات.

التبديل بين تثبيتات npm و git

استخدم القنوات عندما تريد تغيير نوع التثبيت. يحافظ المحدّث على الحالة، والتكوين، وبيانات الاعتماد، ومساحة العمل في ~/.openclaw؛ فهو يغيّر فقط تثبيت كود OpenClaw الذي يستخدمه CLI وGateway.

# npm package install -> editable git checkoutopenclaw update --channel dev # git checkout -> npm package installopenclaw update --channel stable

شغّل أولا مع --dry-run لمعاينة تبديل وضع التثبيت الدقيق:

openclaw update --channel dev --dry-runopenclaw update --channel stable --dry-run

تضمن قناة dev وجود git checkout، وتبنيه، وتثبّت CLI العام من ذلك checkout. تستخدم قناتا stable وbeta تثبيتات الحزم. إذا كان Gateway مثبتا بالفعل، فإن openclaw update يحدّث بيانات تعريف الخدمة ويعيد تشغيلها ما لم تمرر --no-restart.

بالنسبة إلى تثبيتات الحزم مع خدمة Gateway مُدارة، يستهدف openclaw update جذر الحزمة الذي تستخدمه تلك الخدمة. إذا كان أمر shell openclaw يأتي من تثبيت مختلف، يطبع المحدّث كلا الجذرين ومسار Node للخدمة المُدارة. يستخدم تحديث الحزمة مدير الحزم الذي يملك جذر الخدمة ويتحقق من Node الخاص بالخدمة المُدارة مقابل متطلبات المحرك للإصدار الهدف قبل استبدال الحزمة.

بديل: إعادة تشغيل المثبّت

curl -fsSL https://openclaw.ai/install.sh | bash

أضف --no-onboard لتجاوز الإعداد الأولي. لفرض نوع تثبيت محدد عبر المثبّت، مرر --install-method git --no-onboard أو --install-method npm --no-onboard.

إذا فشل openclaw update بعد مرحلة تثبيت حزمة npm، فأعد تشغيل المثبّت. لا يستدعي المثبّت المحدّث القديم؛ بل يشغّل تثبيت الحزمة العامة مباشرة ويمكنه استرداد تثبيت npm محدّث جزئيا.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

لتثبيت الاسترداد على إصدار أو dist-tag محدد، أضف --version:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

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

npm i -g openclaw@latest

فضّل openclaw update للتثبيتات الخاضعة للإشراف لأنه يستطيع تنسيق تبديل الحزمة مع خدمة Gateway العاملة. إذا حدّثت يدويا في تثبيت خاضع للإشراف، فأوقف Gateway المُدار قبل أن يبدأ مدير الحزم. تستبدل مدراء الحزم الملفات في مكانها، وقد يحاول Gateway العامل بخلاف ذلك تحميل ملفات core أو Plugin بينما تكون شجرة الحزمة مستبدلة جزئيا مؤقتا. أعد تشغيل Gateway بعد انتهاء مدير الحزم حتى تلتقط الخدمة التثبيت الجديد.

بالنسبة إلى تثبيت عام على مستوى نظام Linux مملوك للجذر، إذا فشل openclaw update مع EACCES واستعدت باستخدام npm النظام، فأبق Gateway متوقفا طوال استبدال الحزمة اليدوي. استخدم أعلام ملف تعريف openclaw نفسها أو البيئة التي تستخدمها عادة لذلك Gateway. استبدل /usr/bin/npm بـ npm النظام الذي يملك البادئة العامة المملوكة للجذر على مضيفك:

openclaw gateway stopsudo /usr/bin/npm i -g openclaw@latestopenclaw gateway install --forceopenclaw gateway restart

ثم تحقق من الخدمة:

openclaw --versioncurl -fsS http://127.0.0.1:18789/readyzopenclaw plugins list --jsonopenclaw gateway status --deep --jsonopenclaw doctor --lint --json

عندما يدير openclaw update تثبيت npm عاما، فإنه يثبّت الهدف أولا في بادئة npm مؤقتة، ويتحقق من مخزون dist المعبأ، ثم يبدّل شجرة الحزمة النظيفة إلى البادئة العامة الفعلية. يتجنب ذلك قيام npm بتركيب حزمة جديدة فوق ملفات قديمة من الحزمة السابقة. إذا فشل أمر التثبيت، يعيد OpenClaw المحاولة مرة واحدة مع --omit=optional. تساعد إعادة المحاولة هذه المضيفات التي لا يمكن فيها تجميع التبعيات الاختيارية الأصلية، مع إبقاء الفشل الأصلي مرئيا إذا فشل الرجوع الاحتياطي أيضا.

كما تمسح أوامر تحديث npm وتحديث Plugins المُدارة من OpenClaw حجر min-release-age الخاص بـ npm لعملية npm الفرعية. قد يبلّغ npm عن تلك السياسة كحد before مشتق؛ وكلاهما مفيد لسياسات حجر سلسلة التوريد العامة، لكن تحديث OpenClaw الصريح يعني "ثبّت إصدار OpenClaw المحدد الآن."

pnpm add -g openclaw@latest

bun add -g openclaw@latest

موضوعات متقدمة لتثبيت npm

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

المحدّث التلقائي

يكون المحدّث التلقائي متوقفا افتراضيا. فعّله في ~/.openclaw/openclaw.json:

{  update: {    channel: "stable",    auto: {      enabled: true,      stableDelayHours: 6,      stableJitterHours: 12,      betaCheckIntervalHours: 1,    },  },}

يسجل Gateway أيضا تلميح تحديث عند بدء التشغيل (عطّله باستخدام update.checkOnStart: false). لخفض الإصدار أو الاسترداد من حادث، اضبط OPENCLAW_NO_AUTO_UPDATE=1 في بيئة Gateway لحظر التطبيقات التلقائية حتى عندما يكون update.auto.enabled مكوّنا. يمكن أن تظل تلميحات تحديث بدء التشغيل تعمل ما لم يكن update.checkOnStart معطلا أيضا.

لا تستبدل تحديثات مدير الحزم المطلوبة عبر معالج مستوى التحكم الحي في Gateway شجرة الحزمة داخل عملية Gateway العاملة. في تثبيتات الخدمة المُدارة، يبدأ Gateway تسليما منفصلا، ويخرج، ويترك مسار CLI المعتاد openclaw update --yes --json يوقف الخدمة، ويستبدل الحزمة، ويحدّث بيانات تعريف الخدمة، ويعيد التشغيل، ويتحقق من إصدار Gateway وقابلية الوصول، ويسترد LaunchAgent مثبتا لكن غير محمّل على macOS عندما يكون ذلك ممكنا. إذا لم يستطع Gateway تنفيذ ذلك التسليم بأمان، يبلّغ update.run عن أمر shell آمن بدلا من تشغيل مدير الحزم داخل العملية.

بعد التحديث

openclaw doctor

openclaw gateway restart

openclaw health

التراجع

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

npm i -g openclaw@<version>openclaw doctoropenclaw gateway restart

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

git fetch origingit checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"pnpm install && pnpm buildopenclaw gateway restart

للعودة إلى الأحدث: git checkout main && git pull.

إذا كنت عالقا

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

ذات صلة

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