openclaw migrate

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

الأوامر

openclaw migrate listopenclaw migrate claude --dry-runopenclaw migrate codex --dry-runopenclaw migrate codex --skill gog-vault77-google-workspaceopenclaw migrate codex --plugin google-calendar --dry-runopenclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-runopenclaw migrate hermes --dry-runopenclaw migrate hermesopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --plugin google-calendaropenclaw migrate apply codex --yesopenclaw migrate apply claude --yesopenclaw migrate apply hermes --yesopenclaw migrate apply hermes --include-secrets --yesopenclaw onboard --flow importopenclaw onboard --import-from claude --import-source ~/.claudeopenclaw onboard --import-from hermes --import-source ~/.hermes

يؤدي تشغيل openclaw migrate <provider> من دون أي علامات أخرى إلى إنشاء الخطة ومعاينتها، ثم المطالبة بالتأكيد (في TTY) قبل تطبيقها. يفصل openclaw migrate plan <provider> وopenclaw migrate apply <provider> المعاينة والتطبيق في أمرين فرعيين مستقلين يستخدمان العلامات نفسها.

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> تجاوز دليل الحالة المصدر. القيمة الافتراضية لـ Hermes هي ~/.hermes، ولـ Codex هي ~/.codex (أو $CODEX_HOME)، ولـ Claude هي ~/.claude.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcGx1Z2luIDxuYW1l " type="string"> حدّد عنصر تثبيت Plugin واحدًا لـ Codex بحسب اسم Plugin أو معرّف العنصر. كرّر العلامة لترحيل عدة plugins لـ Codex. عند حذفها، تعرض عمليات ترحيل Codex التفاعلية محدّدًا أصليًا بمربعات اختيار لـ plugins الخاصة بـ Codex، بينما تحتفظ عمليات الترحيل غير التفاعلية بجميع plugins المخطّط لها. ينطبق هذا فقط على plugins الخاصة بـ Codex من openai-curated والمثبّتة من المصدر، التي يكتشفها مخزون خادم تطبيق Codex.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tYmFja3VwLW91dHB1dCA8cGF0aA " type="string"> مسار أرشيف النسخة الاحتياطية السابقة للترحيل أو دليلها. يُمرَّر إلى openclaw backup create.

نموذج الأمان

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

موفّر Claude

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

ما يستورده Claude

• ملفا المشروع CLAUDE.md و.claude/CLAUDE.md إلى مساحة عمل وكيل OpenClaw (AGENTS.md).
• يُلحق ملف المستخدم ~/.claude/CLAUDE.md بملف مساحة العمل USER.md.
• تعريفات خوادم MCP من ملف المشروع .mcp.json، وملف Claude Code ‏~/.claude.json (بما في ذلك إدخالاته الخاصة بكل مشروع)، وملف Claude Desktop ‏claude_desktop_config.json.
• أدلة Skills الخاصة بـ Claude التي تتضمن SKILL.md (دليل المستخدم ~/.claude/skills ودليل المشروع .claude/skills).
• ملفات أوامر Markdown الخاصة بـ Claude (دليل المستخدم ~/.claude/commands ودليل المشروع .claude/commands) بعد تحويلها إلى Skills خاصة بـ OpenClaw لا يمكن استدعاؤها إلا يدويًا.

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

يُحتفظ بخطافات Claude والأذونات والقيم الافتراضية للبيئة وملف المشروع CLAUDE.local.md و.claude/rules وأدلة agents/ الخاصة بالمستخدم والمشروع وسجل المشروع (projects وcache وplans ضمن ~/.claude) في تقرير الترحيل أو يُبلّغ عنها بوصفها عناصر تتطلب مراجعة يدوية. لا ينفّذ OpenClaw الخطافات، ولا ينسخ قوائم السماح الواسعة، ولا يستورد تلقائيًا حالة بيانات اعتماد OAuth أو Desktop.

موفّر Codex

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

استخدم هذا الموفّر عند الانتقال إلى بيئة تشغيل Codex في OpenClaw ورغبتك في ترقية أصول Codex CLI الشخصية المفيدة بصورة مقصودة. تستخدم عمليات تشغيل خادم تطبيق Codex المحلية قيمة CODEX_HOME خاصة بكل وكيل، لذلك لا تقرأ ~/.codex الشخصي افتراضيًا. تظل قيمة HOME العادية للعملية موروثة، لذا يمكن لـ Codex رؤية إدخالات Skills وسوق plugins المشتركة ضمن $HOME/.agents/*، ويمكن للعمليات الفرعية العثور على إعدادات المستخدم ورموزه المميزة في دليله الرئيسي.

يؤدي تشغيل openclaw migrate codex في طرفية تفاعلية إلى معاينة الخطة الكاملة، ثم فتح محددات بمربعات اختيار قبل تأكيد التطبيق النهائي. تظهر المطالبة بعناصر نسخ Skills أولًا. استخدم Toggle all on أو Toggle all off للتحديد الجماعي. اضغط على مفتاح المسافة لتبديل الصفوف، أو Enter لتنشيط الصف المميز والمتابعة. تبدأ Skills المخطّط لها محددة، وتبدأ Skills المتعارضة غير محددة، ويتخطى Skip for now نسخ Skills في هذا التشغيل مع الاستمرار في تحديد plugins. عندما يمكن ترحيل plugins المنسقة الخاصة بـ Codex والمثبّتة من المصدر، ولم تُمرر --plugin، يطالب الترحيل بعد ذلك بتنشيط Plugin الأصلي لـ Codex حسب اسم Plugin. تبدأ عناصر Plugin محددة ما لم تكن إعدادات Plugin المستهدف لـ Codex في OpenClaw تحتوي على ذلك الـ Plugin بالفعل. تبدأ plugins الموجودة في الوجهة غير محددة وتعرض تلميح تعارض مثل conflict: plugin exists؛ اختر Toggle all off لعدم ترحيل أي plugins أصلية لـ Codex في ذلك التشغيل، أو Skip for now للتوقف قبل التطبيق.

لعمليات التشغيل البرمجية أو الدقيقة، حدّد Skills أو plugins واحدة أو أكثر صراحةً:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate codex --dry-run --plugin google-calendaropenclaw migrate apply codex --yes --plugin google-calendar

ما يستورده Codex

• أدلة Skills الخاصة بـ Codex CLI ضمن $CODEX_HOME/skills، باستثناء ذاكرة التخزين المؤقت .system الخاصة بـ Codex.
• AgentSkills الشخصية ضمن $HOME/.agents/skills، وتُنسخ إلى مساحة عمل وكيل OpenClaw الحالية لتكون مملوكة لكل وكيل.
• plugins الخاصة بـ Codex من openai-curated والمثبّتة من المصدر، التي تُكتشف عبر plugin/list في خادم تطبيق Codex. يقرأ التخطيط plugin/read لكل Plugin مثبّت ومفعّل.

يخضع ترحيل plugins المدعومة بالتطبيقات لبوابات إضافية:

• تتطلب plugins المدعومة بالتطبيقات أن يكون حساب خادم تطبيق Codex المصدر حساب اشتراك ChatGPT. تُتخطى الاستجابات غير المرتبطة بـ ChatGPT أو التي لا تتضمن حسابًا، مع السبب codex_subscription_required.
• لا يستدعي الترحيل افتراضيًا app/list في المصدر، لذلك يُخطّط للـ plugins المدعومة بالتطبيقات التي تجتاز بوابة الحساب من دون التحقق من إمكانية الوصول إلى تطبيق المصدر، بينما تؤدي إخفاقات نقل البحث عن الحساب إلى التخطي مع السبب codex_account_unavailable.
• مرّر --verify-plugin-apps لفرض لقطة جديدة من app/list في المصدر، واشتراط أن يكون كل تطبيق مملوك موجودًا ومفعّلًا ويمكن الوصول إليه قبل التخطيط للتنشيط الأصلي. في هذا الوضع، تنتقل إخفاقات نقل البحث عن الحساب إلى التحقق من مخزون تطبيقات المصدر. تُحتفظ اللقطة في الذاكرة للعملية الحالية فقط؛ ولا تُكتب مطلقًا في مخرجات الترحيل أو إعدادات الوجهة.

تتحول plugins المعطّلة، وتفاصيل Plugin غير القابلة للقراءة، وحسابات المصدر المحكومة بالاشتراك، وكذلك التطبيقات المفقودة أو المعطّلة أو التي يتعذر الوصول إليها عند ضبط --verify-plugin-apps، إلى عناصر متخطاة يدويًا ذات أسباب مصنفة بدلًا من إدخالات إعدادات الوجهة. يستدعي التطبيق plugin/install في خادم التطبيق لكل Plugin مؤهل ومحدد، حتى إذا أبلغ خادم التطبيق المستهدف بالفعل عن تثبيت ذلك الـ Plugin وتفعيله. لا يمكن استخدام plugins الخاصة بـ Codex بعد ترحيلها إلا في الجلسات التي تحدد بيئة تشغيل Codex الأصلية؛ ولا تتاح لعمليات تشغيل موفّر OpenClaw، أو ارتباطات محادثات ACP، أو بيئات التشغيل الأخرى.

حالة Codex التي تتطلب مراجعة يدوية

لا تُفعّل تلقائيًا إعدادات Codex في config.toml والخطافات الأصلية في hooks/hooks.json والأسواق غير المنسقة وحزم plugins المخزنة مؤقتًا التي ليست plugins منسقة ومثبّتة من المصدر، وكذلك plugins المثبّتة من المصدر التي تفشل في اجتياز بوابة اشتراك المصدر. عند ضبط --verify-plugin-apps، تُتخطى أيضًا plugins التي تفشل في اجتياز بوابة مخزون تطبيقات المصدر. تُنسخ جميع هذه العناصر أو يُبلّغ عنها في تقرير الترحيل للمراجعة اليدوية.

بالنسبة إلى plugins المنسقة والمثبّتة من المصدر التي جرى ترحيلها، يكتب التطبيق:

• plugins.entries.codex.enabled: true
• plugins.entries.codex.config.codexPlugins.enabled: true
• plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true
• إدخال Plugin صريح واحد يحتوي على marketplaceName: "openai-curated" وpluginName لكل Plugin محدد

لا يكتب الترحيل مطلقًا plugins["*"] ولا يخزّن مسارات ذاكرة التخزين المؤقت للسوق المحلي.

لا تُكتب الإضافات التي تم تخطيها في إعدادات الوجهة. تُبلَّغ حالات فشل الاشتراك من جهة المصدر في العناصر اليدوية مع أسباب محددة النوع: codex_subscription_required أو codex_account_unavailable أو plugin_disabled أو plugin_read_unavailable. وعند استخدام --verify-plugin-apps، قد تظهر أيضًا حالات فشل جرد التطبيقات في المصدر على هيئة app_inaccessible أو app_disabled أو app_missing أو app_inventory_unavailable. تُبلَّغ عمليات التثبيت التي تتطلب مصادقة من جهة الوجهة في عنصر الإضافة المتأثر مع status: "skipped" وreason: "auth_required" ومعرّفات تطبيقات منقّحة؛ وتُكتب إدخالات إعداداتها الصريحة معطّلة إلى أن تعيد تفويضها وتمكّنها. أما حالات فشل التثبيت الأخرى فتُرجع نتائج error خاصة بكل عنصر.

إذا لم يكن جرد إضافات خادم تطبيق Codex متاحًا أثناء التخطيط، فستعود عملية الترحيل إلى عناصر إرشادية مخزنة مؤقتًا للحزمة بدلًا من إفشال عملية الترحيل بأكملها.

موفّر 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.
• بيانات اعتماد OpenAI عبر OAuth الخاصة بـ OpenCode من ملف auth.json في OpenCode عند قبول ترحيل بيانات الاعتماد التفاعلي، أو عند تعيين --include-secrets. تُعد إدخالات OAuth في auth.json الخاص بـ Hermes حالة قديمة يُبلَّغ عنها لإعادة المصادقة اليدوية مع OpenAI أو لإصلاحها بواسطة الطبيب.
• مفاتيح API والرموز المميزة المدعومة من ملف .env الخاص بـ Hermes وملف auth.json الخاص بـ OpenCode عند قبول ترحيل بيانات الاعتماد التفاعلي، أو عند تعيين --include-secrets.

مفاتيح .env المدعومة

AI_GATEWAY_API_KEY, ALIBABA_API_KEY, ANTHROPIC_API_KEY, ARCEEAI_API_KEY, CEREBRAS_API_KEY, CHUTES_API_KEY, CLOUDFLARE_AI_GATEWAY_API_KEY, COPILOT_GITHUB_TOKEN, DASHSCOPE_API_KEY, DEEPINFRA_API_KEY, DEEPSEEK_API_KEY, FIREWORKS_API_KEY, GEMINI_API_KEY, GH_TOKEN, GITHUB_TOKEN, GLM_API_KEY, GOOGLE_API_KEY, GROQ_API_KEY, HF_TOKEN, HUGGINGFACE_HUB_TOKEN, KILOCODE_API_KEY, KIMICODE_API_KEY, KIMI_API_KEY, MINIMAX_API_KEY, MINIMAX_CODING_API_KEY, MISTRAL_API_KEY, MODELSTUDIO_API_KEY, MOONSHOT_API_KEY, NVIDIA_API_KEY, OPENAI_API_KEY, OPENCODE_API_KEY, OPENCODE_GO_API_KEY, OPENCODE_ZEN_API_KEY, OPENROUTER_API_KEY, QIANFAN_API_KEY, QWEN_API_KEY, TOGETHER_API_KEY, VENICE_API_KEY, XAI_API_KEY, XIAOMI_API_KEY, ZAI_API_KEY, Z_AI_API_KEY.

حالة مخصصة للأرشفة فقط

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

بعد التطبيق

openclaw doctor

عقد Plugin

مصادر الترحيل هي إضافات. تعلن الإضافة عن معرّفات موفّريها في openclaw.plugin.json:

{  "contracts": {    "migrationProviders": ["hermes"]  }}

في وقت التشغيل، تستدعي الإضافة api.registerMigrationProvider(...). ينفّذ الموفّر الدوال detect وplan وapply. يتولى النواة تنسيق CLI وسياسة النسخ الاحتياطي والمطالبات وإخراج JSON والفحص المسبق للتعارضات. تمرّر النواة الخطة التي تمت مراجعتها إلى apply(ctx, plan)، ولا يجوز للموفّرين إعادة بناء الخطة إلا عندما تكون تلك الوسيطة غير موجودة لأغراض التوافق.

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

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

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

ذو صلة

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