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

Documentation Index

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

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

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

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

يعرض المعالج Claude عندما يكتشف حالة Claude محلية.
openclaw onboard --flow import
أو وجّهه إلى مصدر محدد:
openclaw onboard --import-from claude --import-source ~/.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 عند وجودها.
  • تُنسخ مهارات 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 العام لديك أثناء استيراد جذر مشروع.

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

1

معاينة الخطة

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

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

openclaw migrate apply claude --yes
ينشئ OpenClaw نسخة احتياطية ويتحقق منها قبل التطبيق.
3

تشغيل doctor

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

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

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

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

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

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

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

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

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

​
ذو صلة