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

​
openclaw migrate

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

​
الأوامر

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate codex --plugin google-calendar --dry-run
openclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-run
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --plugin google-calendar
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
​
<provider>
string
اسم موفر ترحيل مسجل، مثل hermes. شغّل openclaw migrate list لرؤية الموفرات المثبتة.
​
--dry-run
boolean
أنشئ الخطة واخرج بدون تغيير الحالة.
​
--from <path>
string
تجاوز دليل حالة المصدر. يستخدم Hermes القيمة الافتراضية ~/.hermes.
​
--include-secrets
boolean
استورد بيانات الاعتماد المدعومة بدون طلب تأكيد. يطلب التطبيق التفاعلي التأكيد قبل استيراد بيانات اعتماد المصادقة المكتشفة، مع اختيار نعم افتراضيا؛ ويتطلب --yes غير التفاعلي استخدام --include-secrets لاستيرادها.
​
--no-auth-credentials
boolean
تخط استيراد بيانات اعتماد المصادقة، بما في ذلك المطالبة التفاعلية.
​
--overwrite
boolean
اسمح للتطبيق باستبدال الأهداف الموجودة عندما تبلغ الخطة عن تعارضات.
​
--yes
boolean
تخط مطالبة التأكيد. مطلوب في الوضع غير التفاعلي.
​
--skill <name>
string
اختر عنصر نسخ مهارة واحدا باسم المهارة أو معرف العنصر. كرر العلامة لترحيل عدة Skills. عند حذفها، تعرض ترحيلات Codex التفاعلية محدد خانات اختيار، وتحتفظ الترحيلات غير التفاعلية بكل Skills المخطط لها.
​
--plugin <name>
string
اختر عنصر تثبيت Plugin واحدا في Codex باسم Plugin أو معرف العنصر. كرر العلامة لترحيل عدة plugins من Codex. عند حذفها، تعرض ترحيلات Codex التفاعلية محدد خانات اختيار أصليا لـ Plugin في Codex، وتحتفظ الترحيلات غير التفاعلية بكل plugins المخطط لها. ينطبق هذا فقط على plugins Codex المثبتة من المصدر من نوع openai-curated التي يكتشفها مخزون خادم تطبيقات Codex.
​
--verify-plugin-apps
boolean
لـ Codex فقط. افرض اجتيازا جديدا من خادم تطبيقات Codex المصدر عبر app/list قبل التخطيط لتفعيل Plugin الأصلي. متوقف افتراضيا لإبقاء تخطيط الترحيل سريعا.
​
--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 إذا كان استبدال الأهداف الموجودة مقصودا. قد تظل الموفرات تكتب نسخا احتياطية على مستوى العنصر للملفات المستبدلة في دليل تقرير الترحيل.
يسأل التطبيق التفاعلي ما إذا كان يجب استيراد بيانات اعتماد المصادقة المكتشفة، مع اختيار نعم افتراضيا. استخدم --no-auth-credentials لتخطيها، أو استخدم --include-secrets لاستيراد بيانات الاعتماد دون حضور مع --yes.

​
موفر 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 تلقائيا.

​
موفر Codex

يكتشف موفر Codex المضمن حالة Codex CLI في ~/.codex افتراضيا، أو في CODEX_HOME عند تعيين متغير البيئة هذا. استخدم --from <path> لـ جرد موطن Codex محدد. استخدم هذا الموفر عند الانتقال إلى حزمة Codex في OpenClaw وعندما تريد ترقية أصول Codex CLI الشخصية المفيدة بشكل متعمد. تستخدم عمليات تشغيل خادم تطبيقات Codex المحلي CODEX_HOME خاصا بكل وكيل، لذلك لا تقرأ ~/.codex الشخصية افتراضيا. لا يزال HOME العادي للعملية موروثا، لذلك يستطيع Codex رؤية Skills المشتركة في $HOME/.agents/* وإدخالات سوق plugins، كما تستطيع العمليات الفرعية العثور على إعدادات ورموز موطن المستخدم. تشغيل openclaw migrate codex في طرفية تفاعلية يعاين الخطة الكاملة، ثم يفتح محددات خانات اختيار قبل تأكيد التطبيق النهائي. تتم مطالبة عناصر نسخ Skills أولا. استخدم Toggle all on أو Toggle all off للتحديد الجماعي. اضغط Space لتبديل الصفوف، أو اضغط Enter لتفعيل الصف المميز والمتابعة. تبدأ Skills المخطط لها محددة، وتبدأ Skills المتعارضة غير محددة، و Skip for now يتخطى نسخ Skills لهذا التشغيل مع الاستمرار إلى تحديد Plugin. عندما تكون plugins Codex المنسقة والمثبتة من المصدر قابلة للترحيل ولم يتم توفير --plugin، يطلب الترحيل بعد ذلك تفعيل Plugin الأصلي في Codex حسب اسم Plugin. تبدأ عناصر Plugin محددة ما لم يكن إعداد Plugin Codex الهدف في OpenClaw يحتوي على ذلك Plugin بالفعل. تبدأ plugins الهدف الموجودة غير محددة وتعرض تلميح تعارض مثل conflict: plugin exists؛ اختر Toggle all off لعدم ترحيل أي plugins Codex أصلية في ذلك التشغيل، أو Skip for now للتوقف قبل التطبيق. للتشغيلات النصية أو الدقيقة، مرر --skill <name> مرة لكل مهارة، على سبيل المثال: 
openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
استخدم --plugin <name> لقصر ترحيل Plugin Codex الأصلي غير التفاعلي على Plugin منسق واحد أو أكثر مثبت من المصدر: 
openclaw migrate codex --dry-run --plugin google-calendar
openclaw 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 المدعومة بتطبيق أن تكون استجابة حساب خادم تطبيقات Codex المصدر حساب اشتراك ChatGPT؛ ويتم تخطي الاستجابات غير التابعة لـ ChatGPT أو المفقودة بسبب codex_subscription_required. افتراضيا، لا يستدعي الترحيل app/list المصدر، لذلك يتم تخطيط plugins المدعومة بتطبيق التي تجتاز بوابة الحساب بدون التحقق من إمكانية وصول تطبيقات المصدر، ويتم تخطي إخفاقات نقل البحث عن الحساب بسبب codex_account_unavailable. مرر --verify-plugin-apps عندما تريد أن يفرض الترحيل لقطة app/list جديدة من المصدر وأن يتطلب وجود كل تطبيق مملوك وتمكينه وإمكانية الوصول إليه قبل التخطيط للتفعيل الأصلي. في ذلك الوضع، تمر إخفاقات نقل البحث عن الحساب إلى التحقق من مخزون تطبيقات المصدر. يتم الاحتفاظ بلقطة مخزون تطبيقات المصدر في الذاكرة للعملية الحالية؛ ولا تتم كتابتها إلى مخرجات الترحيل أو إعدادات الهدف. تصبح plugins المعطلة، وتفاصيل Plugin غير القابلة للقراءة، وحسابات المصدر المقيدة بالاشتراك، وعند طلب التحقق، التطبيقات المفقودة أو المعطلة أو غير القابلة للوصول أو إخفاقات مخزون تطبيقات المصدر عناصر يدوية متخطاة بأسباب مصنفة بدلا من إدخالات إعدادات الهدف. يستدعي التطبيق plugin/install في خادم التطبيقات لكل Plugin مؤهل محدد، حتى إذا كان خادم التطبيقات الهدف يبلغ بالفعل أن ذلك Plugin مثبت وممكن. لا تكون plugins Codex المرحلة قابلة للاستخدام إلا في الجلسات التي تختار حزمة Codex الأصلية؛ ولا يتم عرضها لتشغيلات موفري OpenClaw، أو روابط محادثات ACP، أو الحزم الأخرى.

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

لا يتم تفعيل config.toml الخاص بـ Codex، وhooks/hooks.json الأصلي، والأسواق غير المنسقة، وحزم Plugin المخزنة مؤقتا التي ليست 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. لا تُكتب Plugins المتخطاة في إعدادات الهدف. تُبلّغ عمليات التثبيت التي تتطلب مصادقة في جانب الهدف على عنصر Plugin المتأثر مع status: "skipped" وreason: "auth_required" ومعرّفات تطبيقات منقّحة. تُكتب إدخالات الإعدادات الصريحة الخاصة بها معطّلة إلى أن تعيد التفويض وتمكّنها. أما إخفاقات التثبيت الأخرى فهي نتائج error على مستوى العنصر. إذا لم يكن جرد Plugin خادم تطبيقات 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.
  • بيانات اعتماد OpenCode OpenAI OAuth من auth.json الخاص بـ OpenCode عند قبول هجرة بيانات الاعتماد التفاعلية، أو عند تعيين --include-secrets. تُعد إدخالات OAuth في auth.json الخاص بـ Hermes حالة قديمة يُبلّغ عنها لإعادة تفويض OpenAI يدويًا أو إصلاح doctor.
  • مفاتيح 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

مصادر الهجرة هي 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 نفسه، وما زالا يعرضان معاينة قبل التطبيق.
تتطلب واردات التهيئة الأولية إعداد OpenClaw جديدًا. أعد تعيين الإعدادات وبيانات الاعتماد والجلسات ومساحة العمل أولًا إذا كانت لديك حالة محلية بالفعل. استيرادات النسخ الاحتياطي مع الاستبدال أو الدمج مقيدة بميزة للإعدادات القائمة.

​
ذات صلة