الانتقال إلى المحتوى الرئيسي
OpenClaw يستورد حالة Hermes عبر مزوّد ترحيل مضمّن. يعاين المزوّد كل شيء قبل تغيير الحالة، ويحجب الأسرار في الخطط والتقارير، وينشئ نسخة احتياطية متحقَّقًا منها قبل التطبيق.
تتطلب عمليات الاستيراد إعداد OpenClaw جديدًا. إذا كانت لديك بالفعل حالة OpenClaw محلية، فأعد ضبط الإعدادات وبيانات الاعتماد والجلسات ومساحة العمل أولًا، أو استخدم openclaw migrate مباشرة مع --overwrite بعد مراجعة الخطة.

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

هذا هو المسار الأسرع. يكتشف المعالج Hermes في ~/.hermes ويعرض معاينة قبل التطبيق.
openclaw onboard --flow import
أو وجّهه إلى مصدر محدد:
openclaw onboard --import-from hermes --import-source ~/.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 من ملف OpenCode auth.json، وإدخالات OpenCode وGitHub Copilot من ملف OpenCode auth.json، ومفاتيح .env المدعومة. إدخالات OAuth في ملف Hermes auth.json هي حالة قديمة وتظهر كعمل إعادة مصادقة/doctor يدوي بدلًا من استيرادها إلى المصادقة الحية. استخدم --include-secrets لاستيراد بيانات الاعتماد في openclaw migrate غير التفاعلي، أو --no-auth-credentials لتخطيها، أو --import-secrets في الإعداد الأولي عند الاستيراد من معالج الإعداد الأولي.

​
ما الذي يبقى في الأرشيف فقط

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

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

1

معاينة الخطة

openclaw migrate hermes --dry-run
تسرد الخطة كل ما سيتغير، بما في ذلك التعارضات والعناصر المتخطاة وأي عناصر حساسة. يحجب إخراج الخطة المفاتيح المتداخلة التي تبدو كأسرار.
2

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

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

تشغيل doctor

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

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

openclaw gateway restart
openclaw status
تأكد من أن Gateway سليم وأن النموذج والذاكرة وSkills المستوردة قد تم تحميلها.

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

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

​
الأسرار

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

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

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
مع --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.

​
ذو صلة