الصيانة

دليل الترحيل

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

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

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

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

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

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

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

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

  • --profile <name> (غالبًا ما يصبح ~/.openclaw-<profile>/)
  • 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/<agentId>/...

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

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

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

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

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

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

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

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

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

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

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

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

ذات صلة

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