Skip to main content
يستورد OpenClaw حالة Claude المحلية من خلال موفّر ترحيل Claude المضمّن. يعاين الموفّر كل عنصر قبل تغيير الحالة، ويحجب الأسرار في الخطط والتقارير، وينشئ نسخة احتياطية متحققًا منها قبل التطبيق.
تتطلب عمليات الاستيراد أثناء الإعداد الأولي إعدادًا جديدًا لـ OpenClaw. إذا كانت لديك بالفعل حالة محلية لـ OpenClaw، فأعد ضبط الإعدادات وبيانات الاعتماد والجلسات ومساحة العمل أولًا، أو استخدم openclaw migrate مباشرةً مع --overwrite بعد مراجعة الخطة.

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

يعرض المعالج Claude عندما يكتشف حالة Claude محلية.
أو حدّد مصدرًا معينًا:

​
ما يتم استيراده

  • يُنسخ محتوى CLAUDE.md و.claude/CLAUDE.md الخاص بالمشروع أو يُلحق بملف AGENTS.md في مساحة عمل وكيل OpenClaw.
  • يُلحق محتوى ~/.claude/CLAUDE.md الخاص بالمستخدم بملف USER.md في مساحة العمل.
تُستورد تعريفات خوادم MCP من ملف المشروع .mcp.json، وملف Claude Code‏ ~/.claude.json، وملف Claude Desktop‏ claude_desktop_config.json عند وجودها.
  • تُنسخ 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 الرئيسي العام أثناء الاستيراد من جذر مشروع.

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

1

معاينة الخطة

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

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

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

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

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

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

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

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

يرفض التطبيق المتابعة عندما تُبلغ الخطة عن تعارضات (أي عندما يكون ملف أو قيمة إعدادات موجودًا بالفعل في الوجهة).
أعد التشغيل مع --overwrite فقط عندما يكون استبدال الوجهة الموجودة مقصودًا. قد تظل الموفّرات تكتب نسخًا احتياطية على مستوى العناصر للملفات المستبدلة في دليل تقرير الترحيل.
في تثبيت جديد لـ OpenClaw، تكون التعارضات غير معتادة. وتظهر عادةً عند إعادة تشغيل الاستيراد على إعداد يحتوي بالفعل على تعديلات المستخدم.

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

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

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

مرّر --from /actual/path ‏(CLI) أو --import-source /actual/path (الإعداد الأولي).
تتطلب عمليات الاستيراد أثناء الإعداد الأولي إعدادًا جديدًا. أعد ضبط الحالة وابدأ الإعداد الأولي مجددًا، أو استخدم openclaw migrate apply claude مباشرةً، إذ يدعم --overwrite والتحكم الصريح في النسخ الاحتياطي.
يقرأ Claude Desktop ملف claude_desktop_config.json من مسار خاص بالمنصة. وجّه --from إلى دليل ذلك الملف إذا لم يكتشفه OpenClaw تلقائيًا.
هذا مقصود. يشغّل المستخدم أوامر Claude، لذا يستوردها OpenClaw بوصفها Skills مع disable-model-invocation: true. عدّل البيانات الوصفية الأمامية لكل Skill إذا أردت أن يستدعيها الوكيل تلقائيًا.

​
ذو صلة