Skip to main content
يكتشف موفّر ترحيل Hermes المضمّن الحالة في ~/.hermes، ويعاين كل تغيير قبل تطبيقه، ويحجب الأسرار في الخطط والتقارير، وينشئ نسخة احتياطية متحقَّقًا منها لـ OpenClaw قبل أن يلمس أي شيء.
تتطلب عمليات الاستيراد إعداد OpenClaw جديدًا. إذا كانت لديك بالفعل حالة OpenClaw محلية، فأعد تعيين الإعدادات وبيانات الاعتماد والجلسات ومساحة العمل أولًا، أو استخدم openclaw migrate apply hermes مباشرةً مع --overwrite بعد مراجعة الخطة.

​
طريقتان للاستيراد

يكتشف Hermes في ~/.hermes ويعرض معاينة قبل التطبيق.
أو حدّد مصدرًا بعينه:

​
ما يتم استيراده

  • اختيار النموذج الافتراضي من ملف Hermes ‏config.yaml.
  • موفّرو النماذج المضبوطون ونقاط النهاية المخصصة المتوافقة مع OpenAI من providers وcustom_providers.
تعريفات خوادم MCP من mcp_servers أو mcp.servers.
  • يُنسخ SOUL.md وAGENTS.md إلى مساحة عمل وكيل OpenClaw.
  • تُلحق محتويات memories/MEMORY.md وmemories/USER.md بنهاية ملفات ذاكرة OpenClaw المطابقة بدلًا من الكتابة فوقها.
إعدادات الذاكرة الافتراضية لذاكرة ملفات OpenClaw. تُسجَّل موفّرات الذاكرة الخارجية مثل Honcho كعناصر أرشيف أو مراجعة يدوية كي تتمكن من نقلها بصورة متعمدة.
تُنسخ Skills التي تحتوي على ملف SKILL.md ضمن skills/<name>/، إلى جانب قيم الإعداد الخاصة بكل Skill من skills.config.
يطلب openclaw migrate التفاعلي التأكيد قبل استيراد بيانات اعتماد المصادقة، مع تحديد نعم افتراضيًا. تؤدي الموافقة إلى استيراد إدخالات OpenCode OpenAI OAuth وGitHub Copilot من ملف auth.json الخاص بـ OpenCode، بالإضافة إلى مفاتيح .env المدعومة في Hermes. أما إدخالات OAuth في ملف auth.json الخاص بـ Hermes فهي حالة قديمة: تظهر كعنصر لإعادة المصادقة أو الإصلاح يدويًا بواسطة doctor بدلًا من استيرادها إلى المصادقة النشطة. استخدم --include-secrets لاستيراد بيانات الاعتماد في تشغيل غير تفاعلي، أو --no-auth-credentials لتخطي استيراد بيانات الاعتماد بالكامل، أو علامة معالج الإعداد الأولي --import-secrets.

​
ما يظل في الأرشيف فقط

ينسخ الموفّر العناصر التالية إلى دليل تقرير الترحيل للمراجعة اليدوية، لكنه لا يحمّلها في إعدادات OpenClaw النشطة أو بيانات اعتمادها:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
يرفض OpenClaw تنفيذ هذه الحالة أو الوثوق بها تلقائيًا لأن التنسيقات وافتراضات الثقة قد تتباين بين الأنظمة. انقل ما تحتاج إليه يدويًا بعد مراجعة الأرشيف.

​
المسار الموصى به

1

معاينة الخطة

تسرد الخطة كل ما سيتغير، بما في ذلك التعارضات والعناصر المتخطاة والعناصر الحساسة. تُحجب المفاتيح المتداخلة التي تبدو كأسرار في المخرجات.
2

التطبيق مع نسخة احتياطية

ينشئ OpenClaw نسخة احتياطية ويتحقق منها قبل التطبيق. يستورد هذا المثال غير التفاعلي الحالة غير السرية فقط. شغّله دون --yes للإجابة عن مطالبة بيانات الاعتماد تفاعليًا، أو أضف --include-secrets لتضمين بيانات الاعتماد المدعومة في تشغيل غير مراقَب.
3

تشغيل doctor

يعيد doctor تطبيق أي عمليات ترحيل معلّقة للإعدادات ويتحقق من المشكلات التي نشأت أثناء الاستيراد.
4

إعادة التشغيل والتحقق

تأكد من سلامة Gateway وتحميل النموذج والذاكرة وSkills المستوردة.

​
معالجة التعارضات

يرفض التطبيق المتابعة عندما تُبلغ الخطة عن تعارضات، أي عندما يكون ملف أو قيمة إعداد موجودًا بالفعل في الوجهة.
أعد التشغيل باستخدام --overwrite فقط عندما يكون استبدال الوجهة الحالية مقصودًا. وقد تظل الموفّرات تنشئ نسخًا احتياطية على مستوى العناصر للملفات التي كُتب فوقها في دليل تقرير الترحيل.
التعارضات غير معتادة في التثبيت الجديد. وتظهر عادةً عند إعادة تشغيل الاستيراد على إعداد يتضمن تعديلات أجراها المستخدم بالفعل. إذا ظهر تعارض في منتصف التطبيق، مثل حدوث حالة تسابق غير متوقعة على ملف إعدادات، يضع Hermes علامة skipped على عناصر الإعداد التابعة المتبقية مع السبب blocked by earlier apply conflict بدلًا من كتابتها جزئيًا. يسجّل تقرير الترحيل كل عنصر محظور كي تتمكن من حل التعارض الأصلي وإعادة تشغيل الاستيراد.

​
الأسرار

يسأل openclaw migrate التفاعلي عمّا إذا كنت تريد استيراد بيانات اعتماد المصادقة المكتشفة، مع تحديد نعم افتراضيًا.
  • تؤدي الموافقة إلى استيراد إدخالات OpenCode OpenAI OAuth وGitHub Copilot من ملف auth.json الخاص بـ OpenCode، بالإضافة إلى مفاتيح .env المدعومة. أما إدخالات OAuth في ملف auth.json الخاص بـ Hermes فيُبلّغ عنها لإعادة مصادقة OpenAI يدويًا أو لإصلاحها بواسطة doctor بدلًا من ذلك.
  • استخدم --no-auth-credentials، أو أجب بلا عند المطالبة، لاستيراد الحالة غير السرية فقط.
  • استخدم --include-secrets لاستيراد بيانات الاعتماد في تشغيل --yes غير مراقَب.
  • استخدم علامة معالج الإعداد الأولي --import-secrets لاستيراد بيانات الاعتماد من المعالج.

​
مخرجات JSON للأتمتة

عند استخدام --json دون --yes، يطبع التطبيق الخطة ولا يغيّر الحالة، وهو الوضع الأكثر أمانًا لـ CI والبرامج النصية المشتركة.

​
استكشاف الأخطاء وإصلاحها

افحص مخرجات الخطة. يحدد كل تعارض مسار المصدر والوجهة الحالية. قرر لكل عنصر ما إذا كنت ستتخطاه، أو تعدّل الوجهة، أو تعيد التشغيل باستخدام --overwrite.
مرّر --from /actual/path ‏(CLI) أو --import-source /actual/path ‏(الإعداد الأولي).
تتطلب عمليات الاستيراد عبر الإعداد الأولي إعدادًا جديدًا. إما أن تعيد تعيين الحالة وتبدأ الإعداد الأولي مجددًا، أو تستخدم openclaw migrate apply hermes مباشرةً، فهو يدعم --overwrite والتحكم الصريح في النسخ الاحتياطي.
لا يستورد openclaw migrate التفاعلي مفاتيح API إلا عند قبول مطالبة بيانات الاعتماد. تحتاج عمليات التشغيل غير التفاعلية باستخدام --yes إلى --include-secrets، وتحتاج عمليات الاستيراد عبر الإعداد الأولي إلى --import-secrets. لا يُتعرّف إلا على مفاتيح .env المدعومة، بينما تُتجاهل متغيرات .env الأخرى.

​
ذو صلة