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

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 migrate

استورد الحالة من نظام وكيل آخر عبر موفّر ترحيل مملوك لـ plugin. تغطي الموفّرات المضمّنة Claude وHermes؛ ويمكن لـ plugins خارجية تسجيل موفّرات إضافية.
للاطلاع على الشروحات الموجّهة للمستخدمين، راجع الترحيل من Claude والترحيل من Hermes. يسرد مركز الترحيل كل المسارات.

​
الأوامر

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes
​
<provider>
string
اسم موفّر ترحيل مسجّل، مثل hermes. شغّل openclaw migrate list لرؤية الموفّرات المثبّتة.
​
--dry-run
boolean
أنشئ الخطة واخرج من دون تغيير الحالة.
​
--from <path>
string
تجاوز دليل حالة المصدر. الإعداد الافتراضي لـ Hermes هو ~/.hermes.
​
--include-secrets
boolean
استورد بيانات الاعتماد المدعومة. متوقف افتراضياً.
​
--overwrite
boolean
اسمح للتطبيق باستبدال الأهداف الموجودة عندما تبلّغ الخطة عن تعارضات.
​
--yes
boolean
تخطَّ مطالبة التأكيد. مطلوب في الوضع غير التفاعلي.
​
--no-backup
boolean
تخطَّ النسخ الاحتياطي قبل التطبيق. يتطلب --force عند وجود حالة OpenClaw محلية.
​
--force
boolean
مطلوب مع --no-backup عندما يرفض التطبيق خلاف ذلك تخطي النسخ الاحتياطي.
​
--json
boolean
اطبع الخطة أو نتيجة التطبيق بصيغة JSON. مع --json ومن دون --yes، يطبع التطبيق الخطة ولا يغيّر الحالة.

​
نموذج السلامة

openclaw migrate يعتمد المعاينة أولاً.
يعيد الموفّر خطة مفصلة قبل أن يتغير أي شيء، بما في ذلك التعارضات، والعناصر المتخطاة، والعناصر الحساسة. تحجب خطط JSON، ومخرجات التطبيق، وتقارير الترحيل المفاتيح المتداخلة التي تبدو سرية، مثل مفاتيح API، والرموز، وترويسات التفويض، وملفات تعريف الارتباط، وكلمات المرور.يعاين openclaw migrate apply <provider> الخطة ويطلب التأكيد قبل تغيير الحالة ما لم يتم تعيين --yes. في الوضع غير التفاعلي، يتطلب التطبيق --yes.
ينشئ التطبيق نسخة احتياطية من OpenClaw ويتحقق منها قبل تطبيق الترحيل. إذا لم تكن هناك حالة OpenClaw محلية بعد، يتم تخطي خطوة النسخ الاحتياطي ويمكن للترحيل المتابعة. لتخطي نسخة احتياطية عند وجود حالة، مرّر كلاً من --no-backup و--force.
يرفض التطبيق المتابعة عندما تتضمن الخطة تعارضات. راجع الخطة، ثم أعد التشغيل مع --overwrite إذا كان استبدال الأهداف الموجودة مقصوداً. قد تظل الموفّرات تكتب نسخاً احتياطية على مستوى العناصر للملفات المستبدلة في دليل تقرير الترحيل.
لا يتم استيراد الأسرار افتراضياً مطلقاً. استخدم --include-secrets لاستيراد بيانات الاعتماد المدعومة.

​
موفّر Claude

يكتشف موفّر Claude المضمّن حالة Claude Code في ~/.claude افتراضياً. استخدم --from <path> لاستيراد موطن Claude Code محدد أو جذر مشروع محدد.
للاطلاع على شرح موجّه للمستخدمين، راجع الترحيل من Claude.

​
ما يستورده Claude

  • CLAUDE.md الخاص بالمشروع و.claude/CLAUDE.md إلى مساحة عمل وكيل OpenClaw.
  • تتم إضافة ~/.claude/CLAUDE.md الخاص بالمستخدم إلى USER.md في مساحة العمل.
  • تعريفات خادم MCP من .mcp.json الخاص بالمشروع، و~/.claude.json الخاص بـ Claude Code، وclaude_desktop_config.json الخاص بـ Claude Desktop.
  • أدلة Skills الخاصة بـ Claude التي تتضمن SKILL.md.
  • ملفات Markdown الخاصة بأوامر Claude المحوّلة إلى Skills في OpenClaw مع استدعاء يدوي فقط.

​
حالة الأرشفة والمراجعة اليدوية

يتم الاحتفاظ بخطافات Claude، والأذونات، وافتراضيات البيئة، والذاكرة المحلية، والقواعد المقيّدة بالمسار، والوكلاء الفرعيين، وذاكرات التخزين المؤقت، والخطط، وسجل المشروع في تقرير الترحيل أو الإبلاغ عنها كعناصر للمراجعة اليدوية. لا ينفّذ OpenClaw الخطافات، ولا ينسخ قوائم سماح واسعة، ولا يستورد حالة اعتماد OAuth/Desktop تلقائياً.

​
موفّر Hermes

يكتشف موفّر Hermes المضمّن الحالة في ~/.hermes افتراضياً. استخدم --from <path> عندما يكون 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، بالإضافة إلى عناصر أرشفة أو مراجعة يدوية لموفّري الذاكرة الخارجيين مثل Honcho.
  • Skills التي تتضمن ملف SKILL.md ضمن skills/<name>/.
  • قيم الإعدادات لكل Skill من skills.config.
  • مفاتيح API المدعومة من .env، فقط مع --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.

​
حالة للأرشفة فقط

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

​
بعد التطبيق

openclaw doctor

​
عقد Plugin

مصادر الترحيل هي plugins. يعلن plugin عن معرّفات موفّريه في openclaw.plugin.json: 
{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}
في وقت التشغيل، يستدعي plugin الدالة api.registerMigrationProvider(...). ينفّذ الموفّر detect وplan وapply. يمتلك Core تنسيق CLI، وسياسة النسخ الاحتياطي، والمطالبات، ومخرجات JSON، والفحص المسبق للتعارضات. يمرر Core الخطة المُراجعة إلى apply(ctx, plan)، وقد يعيد الموفّرون بناء الخطة فقط عندما تكون تلك الوسيطة غائبة لأغراض التوافق. يمكن لـ plugins الموفّرة استخدام openclaw/plugin-sdk/migration لإنشاء العناصر وعدّادات الملخص، بالإضافة إلى openclaw/plugin-sdk/migration-runtime لنسخ الملفات الواعي بالتعارضات، ونسخ تقارير الأرشفة فقط، ومغلّفات وقت تشغيل الإعدادات المخزنة مؤقتاً، وتقارير الترحيل.

​
التكامل مع الإعداد الأولي

يمكن للإعداد الأولي عرض الترحيل عندما يكتشف موفّر مصدراً معروفاً. يستخدم كل من openclaw onboard --flow import وopenclaw setup --wizard --import-from hermes موفّر ترحيل plugin نفسه، ويظلان يعرضان معاينة قبل التطبيق.
تتطلب عمليات استيراد الإعداد الأولي إعداد OpenClaw جديداً. أعد ضبط الإعدادات، وبيانات الاعتماد، والجلسات، ومساحة العمل أولاً إذا كانت لديك حالة محلية بالفعل. عمليات الاستيراد بنسخ احتياطي مع استبدال أو دمج محكومة ببوابة ميزات للإعدادات الموجودة.

​
ذات صلة