التحديث¶
يتحرك OpenClaw بسرعة (قبل الإصدار «1.0»). تعامل مع التحديثات كما لو كنت تشغّل بنية تحتية إنتاجية: تحديث → تشغيل الفحوصات → إعادة التشغيل (أو استخدام openclaw update، الذي يعيد التشغيل) → التحقق.
الموصى به: إعادة تشغيل مُثبّت الموقع (ترقية في المكان)¶
مسار التحديث المفضّل هو إعادة تشغيل المُثبّت من الموقع. فهو
يكتشف عمليات التثبيت الموجودة، ويُجري الترقية في المكان، ويشغّل openclaw doctor عند الحاجة.
curl -fsSL https://openclaw.ai/install.sh | bash
ملاحظات:
-
أضِف
--no-onboardإذا كنت لا تريد تشغيل معالج الإعداد الأولي مرة أخرى. -
بالنسبة إلى تثبيتات المصدر، استخدم:
bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
سيقوم المُثبّت بـ git pull --rebase فقط إذا كان المستودع نظيفًا.
-
بالنسبة إلى التثبيتات العامة، يستخدم السكربت
npm install -g openclaw@latestداخليًا. -
ملاحظة قديمة: يظل
clawdbotمتاحًا كطبقة توافق.
قبل التحديث¶
- اعرف طريقة التثبيت: عام (npm/pnpm) مقابل من المصدر (git clone).
- اعرف كيف يعمل Gateway لديك: طرفية أمامية مقابل خدمة مُشرف عليها (launchd/systemd).
- خذ لقطات من تخصيصاتك:
- التهيئة:
~/.openclaw/openclaw.json - بيانات الاعتماد:
~/.openclaw/credentials/ - مساحة العمل:
~/.openclaw/workspace
التحديث (تثبيت عام)¶
التثبيت العام (اختر واحدًا):
npm i -g openclaw@latest
pnpm add -g openclaw@latest
نحن لا نوصي باستخدام Bun لتشغيل Gateway (مشكلات WhatsApp/Telegram).
لتبديل قنوات التحديث (تثبيتات git + npm):
openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable
استخدم --tag <dist-tag|version> لتثبيت وسم/إصدار لمرة واحدة.
راجع قنوات التطوير لمعاني القنوات وملاحظات الإصدار.
ملاحظة: في تثبيتات npm، يسجّل Gateway تلميح تحديث عند بدء التشغيل (يتحقق من وسم القناة الحالية). عطّل ذلك عبر update.checkOnStart: false.
ثم:
openclaw doctor
openclaw gateway restart
openclaw health
ملاحظات:
- إذا كان Gateway يعمل كخدمة، فـ
openclaw gateway restartمُفضّل على قتل أرقام العمليات. - إذا كنت مثبتًا على إصدار محدد، فراجع «التراجع / التثبيت» أدناه.
التحديث (openclaw update)¶
بالنسبة إلى تثبيتات المصدر (git checkout)، يُفضّل:
openclaw update
يشغّل تدفق تحديث آمنًا نسبيًا:
- يتطلب شجرة عمل نظيفة.
- ينتقل إلى القناة المحددة (وسم أو فرع).
- يجلب التحديثات ويُعيد الدمج (rebase) مقابل upstream المُهيّأ (قناة التطوير).
- يثبّت الاعتمادات، ويبني، ويبني واجهة التحكم، ويشغّل
openclaw doctor. - يعيد تشغيل Gateway افتراضيًا (استخدم
--no-restartللتخطي).
إذا ثبّتَّ عبر npm/pnpm (من دون بيانات git)، فسيحاول openclaw update التحديث عبر مدير الحزم لديك. إذا تعذّر عليه اكتشاف التثبيت، فاستخدم «التحديث (تثبيت عام)» بدلًا من ذلك.
التحديث (واجهة التحكم / RPC)¶
تتضمن واجهة التحكم زر Update & Restart (RPC: update.run). وهو:
- يشغّل تدفق تحديث المصدر نفسه مثل
openclaw update(git checkout فقط). - يكتب إشارة إعادة تشغيل مع تقرير مُنظّم (ذيل stdout/stderr).
- يعيد تشغيل Gateway ويُرسل التقرير إلى آخر جلسة نشطة.
إذا فشل rebase، يُجهِض Gateway العملية ويعيد التشغيل دون تطبيق التحديث.
التحديث (من المصدر)¶
من دفع المستعرض:
المفضّل:
openclaw update
يدوي (مماثل تقريبًا):
git pull
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw doctor
openclaw health
ملاحظات:
pnpm buildمهم عندما تشغّل الملف الثنائي المُعبّأopenclaw(openclaw.mjs) أو تستخدم Node لتشغيلdist/.- إذا كنت تشغّل من نسخة مستودع دون تثبيت عام، فاستخدم
pnpm openclaw ...لأوامر CLI. - إذا كنت تشغّل مباشرة من TypeScript (
pnpm openclaw ...)، فإعادة البناء غالبًا غير ضرورية، لكن ترحيلات التهيئة ما تزال مطبّقة → شغّل doctor. - التبديل بين التثبيت العام وتثبيت git سهل: ثبّت النكهة الأخرى، ثم شغّل
openclaw doctorحتى يُعاد كتابة نقطة دخول خدمة Gateway إلى التثبيت الحالي.
شغّل دائمًا: openclaw doctor¶
Doctor هو أمر «التحديث الآمن». إنه مملّ عمدًا: إصلاح + ترحيل + تحذير.
ملاحظة: إذا كنت على تثبيت مصدر (git checkout)، فسيعرض openclaw doctor تشغيل openclaw update أولًا.
أشياء نموذجية يقوم بها:
- ترحيل مفاتيح التهيئة المُهملة / مواقع ملفات التهيئة القديمة.
- تدقيق سياسات الرسائل الخاصة (DM) والتحذير من الإعدادات «المفتوحة» الخطِرة.
- فحص صحة Gateway وقد يعرض إعادة التشغيل.
- اكتشاف وترحيل خدمات Gateway الأقدم (launchd/systemd؛ schtasks القديمة) إلى خدمات OpenClaw الحالية.
- على Linux، التأكد من تمكين systemd user lingering (حتى يستمر Gateway بعد تسجيل الخروج).
التفاصيل: Doctor
بدء / إيقاف / إعادة تشغيل Gateway¶
CLI (يعمل بغضّ النظر عن نظام التشغيل):
openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow
إذا كنت تستخدم إشراف الخدمات:
- macOS launchd (LaunchAgent مُضمّن بالتطبيق):
launchctl kickstart -k gui/$UID/bot.molt.gateway(استخدمbot.molt.<profile>؛ ولا يزالcom.openclaw.*القديم يعمل) - خدمة مستخدم systemd على لينكس:
systemctl --user restart openclaw-gateway[-<profile>].service - ويندوز (WSL2):
systemctl --user restart openclaw-gateway[-<profile>].service - يعمل
launchctl/systemctlفقط إذا كانت الخدمة مُثبّتة؛ وإلا فشغّلopenclaw gateway install.
دليل التشغيل + تسميات الخدمات الدقيقة: دليل تشغيل Gateway
التراجع / التثبيت (عند توقف شيء)¶
التثبيت (تثبيت عام)¶
ثبّت إصدارًا معروفًا يعمل (استبدل <version> بآخر إصدار كان يعمل):
npm i -g openclaw@<version>
pnpm add -g openclaw@<version>
نصيحة: لمعرفة الإصدار المنشور الحالي، شغّل npm view openclaw version.
ثم أعد التشغيل وأعد تشغيل doctor:
openclaw doctor
openclaw gateway restart
التثبيت (من المصدر) حسب التاريخ¶
اختر التزامًا (commit) من تاريخ معيّن (مثال: «حالة main بتاريخ 2026-01-01»):
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مرة أخرى واقرأ المخرجات بعناية (غالبًا ما تخبرك بالحل). - تحقّق من: استكشاف الأخطاء وإصلاحها
- اسأل في Discord: https://discord.gg/clawd