# openclaw migrate

استورد الحالة من نظام وكيل آخر عبر مزود ترحيل مملوك لـ Plugin. تغطي المزودات المضمنة حالة Codex CLI وClaude وHermes؛ ويمكن لـ Plugins الجهات الخارجية تسجيل مزودات إضافية.

# الأوامر

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> اسم مزود ترحيل مسجل، مثل hermes. شغّل openclaw migrate list لرؤية المزودات المثبتة.

--dry-runboolean

ابنِ الخطة واخرج دون تغيير الحالة.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> تجاوز دليل حالة المصدر. يستخدم Hermes افتراضيًا ~/.hermes.

--include-secretsboolean

استورد بيانات الاعتماد المدعومة. معطّل افتراضيًا.

--overwriteboolean

اسمح للتطبيق باستبدال الأهداف الموجودة عندما تبلغ الخطة عن تعارضات.

--yesboolean

تخطَّ مطالبة التأكيد. مطلوب في الوضع غير التفاعلي.

"--skill

--no-backupboolean

تخطَّ النسخة الاحتياطية قبل التطبيق. يتطلب --force عند وجود حالة OpenClaw محلية.

--forceboolean

مطلوب مع --no-backup عندما يرفض التطبيق بخلاف ذلك تخطي النسخ الاحتياطي.

--jsonboolean

اطبع الخطة أو نتيجة التطبيق بتنسيق JSON. مع --json ودون --yes، يطبع التطبيق الخطة ولا يغير الحالة.

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

openclaw migrate يعتمد المعاينة أولًا.

# مزود Claude

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

# ما يستورده 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 تلقائيًا.

# مزود Codex

يكتشف مزود Codex المضمن حالة Codex CLI في ~/.codex افتراضيًا، أو في CODEX_HOME عند ضبط متغير البيئة هذا. استخدم --from <path> من أجل جرد منزل Codex محدد.

استخدم هذا المزود عند الانتقال إلى حاضنة OpenClaw Codex وتريد ترقية أصول Codex CLI الشخصية المفيدة بصورة مقصودة. تستخدم عمليات تشغيل خادم تطبيق Codex المحلية أدلة CODEX_HOME وHOME خاصة بكل وكيل، لذلك لا تقرأ حالة Codex CLI الشخصية افتراضيًا.

يعرض تشغيل openclaw migrate codex في طرفية تفاعلية الخطة الكاملة للمعاينة، ثم يفتح محدد مربعات اختيار لعناصر نسخ Skills قبل تأكيد التطبيق النهائي. استخدم Toggle all on أو Toggle all off للتحديد بالجملة؛ تبدأ Skills المخطط لها محددة، وتبدأ Skills المتعارضة غير محددة، ويترك Skip for now Skills دون تغيير ودون تطبيق. للتشغيل البرمجي أو الدقيق، مرّر --skill <name> مرة واحدة لكل Skills، على سبيل المثال:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

# ما يستورده Codex

• أدلة Skills الخاصة بـ Codex CLI ضمن $CODEX_HOME/skills، مع استثناء ذاكرة التخزين المؤقت .system الخاصة بـ Codex.
• AgentSkills الشخصية ضمن $HOME/.agents/skills، منسوخة إلى مساحة عمل وكيل OpenClaw الحالية عندما تريد ملكية لكل وكيل.

# حالة Codex للمراجعة اليدوية

لا يتم تفعيل Plugins الأصلية لـ Codex وconfig.toml وhooks/hooks.json الأصلية تلقائيًا. قد تعرض Plugins خوادم MCP أو تطبيقات أو خطافات أو سلوكًا تنفيذيًا آخر، لذلك يبلغ المزود عنها للمراجعة بدلًا من تحميلها في OpenClaw. تُنسخ ملفات الإعدادات والخطافات إلى تقرير الترحيل للمراجعة اليدوية.

# مزود 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>/.
• قيم إعدادات كل Skills من 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. يملك النواة تنسيق CLI وسياسة النسخ الاحتياطي والمطالبات ومخرجات JSON والفحص المسبق للتعارضات. تمرر النواة الخطة المراجعة إلى apply(ctx, plan)، وقد تعيد المزودات بناء الخطة فقط عندما تكون تلك الوسيطة غير موجودة للتوافق.

يمكن لـ Plugins المزودات استخدام openclaw/plugin-sdk/migration لإنشاء العناصر وأعداد الملخصات، بالإضافة إلى openclaw/plugin-sdk/migration-runtime لنسخ الملفات الواعية بالتعارضات ونسخ تقارير الأرشفة فقط ومغلفات وقت تشغيل الإعدادات المخزنة مؤقتًا وتقارير الترحيل.

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

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

# ذات صلة

• الترحيل من Hermes: إرشادات موجهة للمستخدم.
• الترحيل من Claude: إرشادات موجهة للمستخدم.
• الترحيل: نقل OpenClaw إلى جهاز جديد.
• Doctor: فحص الصحة بعد تطبيق ترحيل.
• Plugins: تثبيت Plugin وتسجيله.