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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

المسار الأسرع. يكتشف المعالج Hermes في ~/.hermes ويعرض معاينة قبل التطبيق.
openclaw onboard --flow import
أو وجّهه إلى مصدر محدد:
openclaw onboard --import-from hermes --import-source ~/.hermes

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

  • اختيار النموذج الافتراضي من config.yaml في Hermes.
  • مزوّدو النماذج المكوّنون ونقاط النهاية المخصصة المتوافقة مع 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.
عيّن --include-secrets لاستيراد مفاتيح .env المدعومة: OPENAI_API_KEY، ANTHROPIC_API_KEY، OPENROUTER_API_KEY، GOOGLE_API_KEY، GEMINI_API_KEY، GROQ_API_KEY، XAI_API_KEY، MISTRAL_API_KEY، DEEPSEEK_API_KEY. بدون هذا العلم، لا يتم نسخ الأسرار أبدًا.

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

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

​
التدفق الموصى به

1

عاين الخطة

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

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

openclaw migrate apply hermes --yes
تنشئ OpenClaw نسخة احتياطية وتتحقق منها قبل التطبيق. إذا كنت تحتاج إلى استيراد مفاتيح API، فأضف --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 apply hermes --yes أولًا لاستيراد الحالة غير السرية.
  • إذا كنت تريد أيضًا نسخ مفاتيح .env المدعومة، فأعد التشغيل مع --include-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 والتحكم الصريح في النسخ الاحتياطي.
--include-secrets مطلوب، ولا يتم التعرف إلا على المفاتيح المذكورة أعلاه. يتم تجاهل المتغيرات الأخرى في .env.

​
ذو صلة