English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

الترحيل من Claude

يستورد OpenClaw حالة Claude المحلية عبر موفر ترحيل Claude المضمّن. يعاين الموفر كل عنصر قبل تغيير الحالة، ويحجب الأسرار في الخطط والتقارير، وينشئ نسخة احتياطية موثّقة قبل التطبيق.

طريقتان للاستيراد

معالج الإعداد الأولي

يعرض المعالج Claude عندما يكتشف حالة Claude محلية.

openclaw onboard --flow import

أو وجّهه إلى مصدر محدد:

openclaw onboard --import-from claude --import-source ~/.claude

CLI

استخدم openclaw migrate للتشغيلات المبرمجة أو القابلة للتكرار. راجع openclaw migrate للمرجع الكامل.

openclaw migrate claude --dry-run
openclaw migrate apply claude --yes

أضف --from <path> لاستيراد منزل Claude Code محدد أو جذر مشروع محدد.

ما الذي يتم استيراده

التعليمات والذاكرة
  • يُنسخ محتوى CLAUDE.md و.claude/CLAUDE.md الخاص بالمشروع أو يُلحق في AGENTS.md ضمن مساحة عمل وكيل OpenClaw.
  • يُلحق محتوى ~/.claude/CLAUDE.md الخاص بالمستخدم في USER.md ضمن مساحة العمل.
خوادم MCP

تُستورد تعريفات خوادم MCP من .mcp.json الخاص بالمشروع، وملف حالة Claude Code ~/.claude.json، وملف Claude Desktop claude_desktop_config.json عند وجودها.

Skills والأوامر
  • تُنسخ مهارات Claude التي تحتوي على ملف SKILL.md إلى دليل مهارات مساحة عمل OpenClaw.
  • تُحوّل ملفات Markdown الخاصة بأوامر Claude ضمن .claude/commands/ أو ~/.claude/commands/ إلى مهارات OpenClaw مع disable-model-invocation: true.

ما يبقى للأرشيف فقط

ينسخ الموفر هذه العناصر إلى تقرير الترحيل للمراجعة اليدوية، لكنه لا يحمّلها في إعداد OpenClaw الحي:

  • خطافات Claude
  • أذونات Claude وقوائم السماح الواسعة للأدوات
  • الإعدادات الافتراضية لبيئة Claude
  • CLAUDE.local.md
  • .claude/rules/
  • الوكلاء الفرعيون لـ Claude ضمن .claude/agents/ أو ~/.claude/agents/
  • أدلة ذاكرات التخزين المؤقت والخطط وسجل المشاريع في Claude Code
  • إضافات Claude Desktop وبيانات الاعتماد المخزنة في نظام التشغيل

يرفض OpenClaw تنفيذ الخطافات، أو الوثوق بقوائم السماح للأذونات، أو فك ترميز حالة OAuth وبيانات اعتماد Desktop المعتمة تلقائيًا. انقل ما تحتاج إليه يدويًا بعد مراجعة الأرشيف.

اختيار المصدر

من دون --from، يفحص OpenClaw منزل Claude Code الافتراضي في ~/.claude، وملف حالة Claude Code النموذجي ~/.claude.json، وإعداد MCP الخاص بـ Claude Desktop على macOS.

عندما يشير --from إلى جذر مشروع، يستورد OpenClaw ملفات Claude الخاصة بذلك المشروع فقط، مثل CLAUDE.md، و.claude/settings.json، و.claude/commands/، و.claude/skills/، و.mcp.json. ولا يقرأ منزل Claude العام لديك أثناء استيراد جذر مشروع.

التدفق الموصى به

  • معاينة الخطة

    openclaw migrate claude --dry-run

    تسرد الخطة كل ما سيتغير، بما في ذلك التعارضات، والعناصر المتخطاة، والقيم الحساسة المحجوبة من حقول MCP المتداخلة env أو headers.

  • التطبيق مع نسخة احتياطية

    openclaw migrate apply claude --yes

    ينشئ OpenClaw نسخة احتياطية ويتحقق منها قبل التطبيق.

  • تشغيل doctor

    openclaw doctor

    يتحقق Doctor من مشكلات الإعداد أو الحالة بعد الاستيراد.

  • إعادة التشغيل والتحقق

    openclaw gateway restart
openclaw status

    تأكد من أن Gateway سليم وأن التعليمات وخوادم MCP والمهارات المستوردة قد حُمّلت.

    • التعامل مع التعارضات

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

    بالنسبة إلى تثبيت OpenClaw جديد، تكون التعارضات غير معتادة. تظهر عادةً عندما تعيد تشغيل الاستيراد على إعداد يحتوي بالفعل على تعديلات للمستخدم.

    مخرجات JSON للأتمتة

    openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes

    مع --json ومن دون --yes، يطبع التطبيق الخطة ولا يغيّر الحالة. هذا هو الوضع الأكثر أمانًا لـ CI والسكربتات المشتركة.

    استكشاف الأخطاء وإصلاحها

    حالة Claude موجودة خارج ~/.claude

    مرّر --from /actual/path (CLI) أو --import-source /actual/path (الإعداد الأولي).

    الإعداد الأولي يرفض الاستيراد على إعداد موجود

    تتطلب عمليات استيراد الإعداد الأولي إعدادًا جديدًا. إما أن تعيد ضبط الحالة وتعيد الإعداد الأولي، أو تستخدم openclaw migrate apply claude مباشرةً، فهو يدعم --overwrite والتحكم الصريح في النسخ الاحتياطي.

    لم تُستورد خوادم MCP من Claude Desktop

    يقرأ Claude Desktop ملف claude_desktop_config.json من مسار خاص بالمنصة. وجّه --from إلى دليل ذلك الملف إذا لم يكتشفه OpenClaw تلقائيًا.

    تحولت أوامر Claude إلى مهارات مع تعطيل استدعاء النموذج

    هذا مقصود. أوامر Claude يطلقها المستخدم، لذلك يستوردها OpenClaw كمهارات مع disable-model-invocation: true. عدّل frontmatter لكل مهارة إذا كنت تريد من الوكيل استدعاءها تلقائيًا.

    ذو صلة