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

الصيانة

دليل الترحيل

يشرح هذا الدليل كيفية ترحيل بوابة OpenClaw من جهاز إلى آخر دون إعادة عملية الإعداد. الترحيل بسيط من الناحية النظرية:

  • انسخ دليل الحالة ($OPENCLAW_STATE_DIR، الافتراضي: ~/.openclaw/) — وهذا يشمل التكوين والمصادقة والجلسات وحالة القنوات.
  • انسخ مساحة العمل الخاصة بك (~/.openclaw/workspace/ افتراضيًا) — وهذا يشمل ملفات الوكيل (الذاكرة، المطالبات، إلخ).

ولكن هناك أخطاء شائعة تتعلق بـ الملفات الشخصية، الصلاحيات، والنسخ الجزئي.

قبل البدء (ما الذي سترحله)​

1) حدد دليل الحالة الخاص بك​

معظم عمليات التثبيت تستخدم الافتراضي:

  • دليل الحالة: ~/.openclaw/

ولكن قد يكون مختلفًا إذا كنت تستخدم:

  • --profile (غالبًا ما يصبح ~/.openclaw-/)
  • OPENCLAW_STATE_DIR=/some/path

إذا لم تكن متأكدًا، نفّذ على الجهاز القديم:

openclaw status

ابحث عن ذكر OPENCLAW_STATE_DIR / الملف الشخصي في الناتج. إذا كنت تشغّل بوابات متعددة، كرر لكل ملف شخصي.

2) حدد مساحة العمل الخاصة بك​

الافتراضيات الشائعة:

  • ~/.openclaw/workspace/ (مساحة العمل الموصى بها)
  • مجلد مخصص قمت بإنشائه

مساحة العمل هي المكان الذي توجد فيه ملفات مثل MEMORY.md، USER.md، و memory/*.md.

3) افهم ما ستحتفظ به​

إذا نسخت كلاً من دليل الحالة ومساحة العمل، فستحتفظ بـ:

  • تكوين البوابة (openclaw.json)
  • ملفات تعريف المصادقة / مفاتيح API / رموز OAuth
  • سجل الجلسات + حالة الوكيل
  • حالة القناة (مثل تسجيل الدخول/الجلسة في WhatsApp)
  • ملفات مساحة العمل الخاصة بك (الذاكرة، ملاحظات المهارات، إلخ.)

إذا نسخت فقط مساحة العمل (عبر Git مثلاً)، فأنت لا تحتفظ بـ:

  • الجلسات
  • بيانات الاعتماد
  • تسجيلات الدخول للقنوات

تلك موجودة تحت $OPENCLAW_STATE_DIR.

خطوات الترحيل (الموصى بها)​

الخطوة 0 — أنشئ نسخة احتياطية (الجهاز القديم)​

على الجهاز القديم، أوقف البوابة أولاً حتى لا تتغير الملفات أثناء النسخ:

openclaw gateway stop

(اختياري ولكنه موصى به) أرشفة دليل الحالة ومساحة العمل:

# اضبط المسارات إذا كنت تستخدم ملفًا شخصيًا أو مواقع مخصصة
cd ~
tar -czf openclaw-state.tgz .openclaw

tar -czf openclaw-workspace.tgz .openclaw/workspace

إذا كان لديك عدة ملفات شخصية/أدلة حالة (مثل ~/.openclaw-main، ~/.openclaw-work)، قم بأرشفة كل منها.

الخطوة 1 — ثبّت OpenClaw على الجهاز الجديد​

على الجهاز الجديد، ثبّت واجهة سطر الأوامر (و Node إذا لزم الأمر):

في هذه المرحلة، لا بأس إذا أنشأ الإعداد دليل ~/.openclaw/ جديدًا — ستقوم باستبداله في الخطوة التالية.

الخطوة 2 — انسخ دليل الحالة + مساحة العمل إلى الجهاز الجديد​

انسخ كلاً من:

  • $OPENCLAW_STATE_DIR (الافتراضي ~/.openclaw/)
  • مساحة العمل الخاصة بك (الافتراضي ~/.openclaw/workspace/)

الطرق الشائعة:

  • scp لأرشيفات tar واستخراجها
  • rsync -a عبر SSH
  • قرص خارجي

بعد النسخ، تأكد من:

  • تضمين المجلدات المخفية (مثل .openclaw/)
  • أن ملكية الملفات صحيحة للمستخدم الذي يشغّل البوابة

الخطوة 3 — نفّذ Doctor (الترحيلات وإصلاح الخدمة)​

على الجهاز الجديد:

openclaw doctor

Doctor هو الأمر "الآمن والممل". يقوم بإصلاح الخدمات، وتطبيق ترحيلات التكوين، والتحذير من عدم التطابق. ثم:

openclaw gateway restart
openclaw status

الأخطاء الشائعة (وكيفية تجنبها)​

الخطأ: عدم تطابق الملف الشخصي / دليل الحالة​

إذا كنت تشغّل البوابة القديمة بملف شخصي (أو OPENCLAW_STATE_DIR)، والبوابة الجديدة تستخدم إعدادًا مختلفًا، فسترى أعراضًا مثل:

  • تغييرات التكوين لا تُطبق
  • اختفاء القنوات / تسجيل الخروج
  • سجل الجلسات فارغ

الإصلاح: شغّل البوابة/الخدمة باستخدام نفس الملف الشخصي/دليل الحالة الذي رحّلته، ثم أعد تشغيل:

openclaw doctor

الخطأ: نسخ openclaw.json فقط​

openclaw.json ليس كافيًا. العديد من المزودين يخزنون الحالة تحت:

  • $OPENCLAW_STATE_DIR/credentials/
  • $OPENCLAW_STATE_DIR/agents//...

ارحّل دائمًا مجلد $OPENCLAW_STATE_DIR بأكمله.

الخطأ: صلاحيات / ملكية​

إذا نسخت كـ root أو غيرت المستخدمين، فقد تفشل البوابة في قراءة بيانات الاعتماد/الجلسات. الإصلاح: تأكد من أن دليل الحالة + مساحة العمل مملوكان للمستخدم الذي يشغّل البوابة.

الخطأ: الترحيل بين أوضاع البعيد/المحلي​

  • إذا كانت واجهة المستخدم (WebUI/TUI) الخاصة بك تشير إلى بوابة بعيدة، فإن المضيف البعيد يملك مخزن الجلسات + مساحة العمل.
  • ترحيل جهازك المحمول لن ينقل حالة البوابة البعيدة.

إذا كنت في الوضع البعيد، فقم بترحيل مضيف البوابة.

الخطأ: الأسرار في النسخ الاحتياطية​

$OPENCLAW_STATE_DIR يحتوي على أسرار (مفاتيح API، رموز OAuth، بيانات اعتماد WhatsApp). عامل النسخ الاحتياطية كأسرار إنتاجية:

  • خزنها مشفرة
  • تجنب مشاركتها عبر قنوات غير آمنة
  • غيّر المفاتيح إذا اشتبهت في تعرضها

قائمة التحقق للتأكد​

على الجهاز الجديد، أكد:

  • openclaw status يظهر أن البوابة تعمل
  • قنواتك لا تزال متصلة (مثال: WhatsApp لا يتطلب إعادة الاقتران)
  • تفتح لوحة التحكم وتعرض الجلسات الحالية
  • ملفات مساحة العمل الخاصة بك (الذاكرة، التكوينات) موجودة

ذات صلة​

التحديثإلغاء التثبيت