OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

الترحيل من Claude

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

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

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

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

bash
openclaw onboard --flow import

أو حدّد مصدرًا معينًا:

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

CLI

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

bash
openclaw migrate claude --dry-runopenclaw 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 والأوامر
  • تُنسخ Skills الخاصة بـ Claude التي تحتوي على ملف SKILL.md إلى دليل Skills في مساحة عمل OpenClaw.
  • تُحوّل ملفات Markdown لأوامر Claude ضمن .claude/commands/ أو ~/.claude/commands/ إلى Skills في 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 الرئيسي العام أثناء الاستيراد من جذر مشروع.

المسار الموصى به

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

    bash
    openclaw migrate claude --dry-run

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

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

    bash
    openclaw migrate apply claude --yes

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

  • تشغيل أداة التشخيص

    bash
    openclaw doctor

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

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

    bash
    openclaw gateway restartopenclaw status

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

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

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

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

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

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

    يلزم استخدام --yes مع migrate apply خارج الطرفية التفاعلية؛ ومن دونه يعرض OpenClaw خطأ بدلًا من التطبيق، لذا يجب أن تمرّر البرامج النصية وCI الخيار --yes صراحةً. عاين أولًا باستخدام --dry-run --json، ثم طبّق باستخدام --json --yes بعد التأكد من صحة الخطة.

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

    حالة 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 إلى Skills مع تعطيل استدعاء النموذج

    هذا مقصود. يشغّل المستخدم أوامر Claude، لذا يستوردها OpenClaw بوصفها Skills مع disable-model-invocation: true. عدّل البيانات الوصفية الأمامية لكل Skill إذا أردت أن يستدعيها الوكيل تلقائيًا.

    ذو صلة

    Was this useful?
    On this page

    On this page