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

​
ترحيل OpenClaw إلى جهاز جديد

ينقل هذا الدليل gateway الخاصة بـ OpenClaw إلى جهاز جديد من دون إعادة تنفيذ التهيئة الأولية.

​
ما الذي يتم ترحيله

عندما تنسخ دليل الحالة (~/.openclaw/ افتراضيًا) ومساحة العمل الخاصة بك، فإنك تحتفظ بما يلي:
  • التكوين — openclaw.json وجميع إعدادات gateway
  • المصادقة — ملفات auth-profiles.json لكل وكيل (مفاتيح API + OAuth)، بالإضافة إلى أي حالة قنوات/مزوّدات تحت credentials/
  • الجلسات — سجل المحادثة وحالة الوكيل
  • حالة القناة — تسجيل دخول WhatsApp، وجلسة Telegram، وغير ذلك
  • ملفات مساحة العمل — MEMORY.md وUSER.md وSkills والمطالبات
شغّل openclaw status على الجهاز القديم لتأكيد مسار دليل الحالة. تستخدم profiles المخصصة المسار ~/.openclaw-<profile>/ أو مسارًا مضبوطًا عبر OPENCLAW_STATE_DIR.

​
خطوات الترحيل

1

أوقف gateway وخذ نسخة احتياطية

على الجهاز القديم، أوقف gateway حتى لا تتغير الملفات أثناء النسخ، ثم أنشئ أرشيفًا:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
إذا كنت تستخدم profiles متعددة (مثل ~/.openclaw-work)، فأرشف كل واحدة على حدة.
2

ثبّت OpenClaw على الجهاز الجديد

ثبّت CLI (وNode إذا لزم) على الجهاز الجديد. لا بأس إذا أنشأت التهيئة الأولية ~/.openclaw/ جديدة — فسوف تستبدلها بعد ذلك.
3

انسخ دليل الحالة ومساحة العمل

انقل الأرشيف عبر scp أو rsync -a أو قرص خارجي، ثم استخرجه:
cd ~
tar -xzf openclaw-state.tgz
تأكد من تضمين الأدلة المخفية ومن أن ملكية الملفات تطابق المستخدم الذي سيشغّل gateway.
4

شغّل doctor وتحقق

على الجهاز الجديد، شغّل Doctor لتطبيق عمليات ترحيل التكوين وإصلاح الخدمات:
openclaw doctor
openclaw gateway restart
openclaw status

​
المشكلات الشائعة

إذا كانت gateway القديمة تستخدم --profile أو OPENCLAW_STATE_DIR بينما لا تستخدم الجديدة ذلك، فستبدو القنوات وكأنها مسجّلة الخروج وستكون الجلسات فارغة. شغّل gateway باستخدام profile أو state-dir نفسها التي قمت بترحيلها، ثم أعد تشغيل openclaw doctor.
ملف التكوين وحده لا يكفي. تعيش ملفات تعريف مصادقة النموذج تحت agents/<agentId>/agent/auth-profiles.json، كما أن حالة القناة/المزوّد ما زالت تعيش تحت credentials/. احرص دائمًا على ترحيل دليل الحالة بالكامل.
إذا نسخت كـ root أو بدّلت المستخدمين، فقد تفشل gateway في قراءة بيانات الاعتماد. تأكد من أن دليل الحالة ومساحة العمل مملوكان للمستخدم الذي يشغّل gateway.
إذا كانت واجهة المستخدم لديك تشير إلى gateway بعيدة، فإن المضيف البعيد هو الذي يملك الجلسات ومساحة العمل. رحّل مضيف gateway نفسه، وليس حاسوبك المحمول المحلي. راجع الأسئلة الشائعة.
يحتوي دليل الحالة على ملفات تعريف المصادقة وبيانات اعتماد القنوات وحالة المزوّدات الأخرى. خزّن النسخ الاحتياطية بشكل مشفّر، وتجنب قنوات النقل غير الآمنة، ودوّر المفاتيح إذا شككت في حدوث تعرّض.

​
قائمة التحقق من التحقق

على الجهاز الجديد، تأكد من:
  • أن openclaw status يظهر أن gateway تعمل
  • أن القنوات ما تزال متصلة (ولا حاجة إلى إعادة pairing)
  • أن dashboard تفتح وتعرض الجلسات الموجودة
  • أن ملفات مساحة العمل (الذاكرة، والتكوينات) موجودة