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

Documentation Index

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

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

​
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
استورد بيانات الاعتماد المدعومة. تكون متوقفة افتراضيًا.
​
--overwrite
boolean
اسمح للتطبيق باستبدال الأهداف الحالية عندما تبلغ الخطة عن تعارضات.
​
--yes
boolean
تخطَّ مطالبة التأكيد. مطلوب في الوضع غير التفاعلي.
​
--skill <name>
string
حدد عنصر نسخ مهارة واحدًا باسم المهارة أو معرّف العنصر. كرر العلامة لترحيل عدة مهارات. عند حذفها، تعرض عمليات ترحيل Codex التفاعلية محدد مربعات اختيار، وتحتفظ عمليات الترحيل غير التفاعلية بكل المهارات المخططة.
​
--plugin <name>
string
حدد عنصر تثبيت Plugin واحدًا في Codex باسم Plugin أو معرّف العنصر. كرر العلامة لترحيل عدة plugins من Codex. عند حذفها، تعرض عمليات ترحيل Codex التفاعلية محدد مربعات اختيار Plugin أصلي في Codex، وتحتفظ عمليات الترحيل غير التفاعلية بكل plugins المخططة. ينطبق هذا فقط على plugins Codex المثبتة في المصدر من openai-curated التي يكتشفها مخزون خادم تطبيق Codex.
​
--verify-plugin-apps
boolean
لـ Codex فقط. افرض اجتيازًا جديدًا لـ app/list من خادم تطبيق Codex المصدر قبل التخطيط لتفعيل 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 إذا كان استبدال الأهداف الحالية مقصودًا. قد تستمر المزودات في كتابة نسخ احتياطية على مستوى العنصر للملفات المستبدلة في دليل تقرير الترحيل.
لا يتم استيراد الأسرار افتراضيًا أبدًا. استخدم --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.
  • أدلة مهارات Claude التي تتضمن SKILL.md.
  • ملفات Markdown لأوامر Claude المحوّلة إلى مهارات 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 في طرفية تفاعلية الخطة الكاملة أولًا، ثم يفتح محددات مربعات اختيار قبل تأكيد التطبيق النهائي. تتم المطالبة بعناصر نسخ المهارات أولًا. استخدم Toggle all on أو Toggle all off للاختيار بالجملة. اضغط Space لتبديل الصفوف، أو اضغط Enter لتنشيط الصف المظلل والمتابعة. تبدأ المهارات المخططة محددة، وتبدأ المهارات المتعارضة غير محددة، و Skip for now يتخطى نسخ المهارات لهذا التشغيل مع الاستمرار في اختيار Plugin. عندما تكون plugins Codex المنسقة والمثبتة في المصدر قابلة للترحيل ولم يتم توفير --plugin، يطلب الترحيل بعد ذلك تفعيل Plugin الأصلي في Codex حسب اسم Plugin. تبدأ عناصر Plugin محددة ما لم يكن تكوين Plugin الخاص بـ OpenClaw Codex الهدف يحتوي بالفعل على ذلك 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 واحد أو أكثر من plugins المنسقة المثبتة في المصدر: 
openclaw migrate codex --dry-run --plugin google-calendar
openclaw migrate apply codex --yes --plugin google-calendar

​
ما يستورده Codex

  • أدلة مهارات 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 الأصلية؛ ولا تُعرض على Pi أو تشغيلات مزود OpenAI العادية أو روابط محادثات 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.
  • مفاتيح 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)، ويمكن للموفرين إعادة بناء الخطة فقط عندما تكون تلك الوسيطة غائبة للتوافق. يمكن لـ Provider plugins استخدام openclaw/plugin-sdk/migration لإنشاء العناصر وعدّادات الملخص، إضافة إلى openclaw/plugin-sdk/migration-runtime لنسخ الملفات المدركة للتعارضات، ونسخ تقارير الأرشفة فقط، ومغلفات config-runtime المخزنة مؤقتًا، وتقارير الترحيل.

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

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

​
ذات صلة