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

برای واردکردن یک پوشه خانه مشخص Claude Code یا ریشه پروژه، --from <path> را اضافه کنید.

مواردی که وارد می‌شوند

دستورالعمل‌ها و حافظه
  • محتوای CLAUDE.md و .claude/CLAUDE.md پروژه در AGENTS.md فضای کاری عامل OpenClaw کپی یا به آن افزوده می‌شود.
  • محتوای ~/.claude/CLAUDE.md کاربر به USER.md فضای کاری افزوده می‌شود.
سرورهای MCP

در صورت وجود، تعریف‌های سرور MCP از .mcp.json پروژه، ~/.claude.json در Claude Code و claude_desktop_config.json در Claude Desktop وارد می‌شوند.

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

    برنامه همه مواردی را که تغییر خواهند کرد فهرست می‌کند؛ از جمله تعارض‌ها، موارد ردشده و مقادیر حساس پنهان‌شده از فیلدهای تو‌در‌توی env یا headers مربوط به MCP.

  • اعمال همراه با نسخه پشتیبان

    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 را از مسیری مختص پلتفرم می‌خواند. اگر OpenClaw آن را به‌طور خودکار تشخیص نداد، --from را به پوشه آن فایل اشاره دهید.

    فرمان‌های Claude با غیرفعال‌بودن فراخوانی مدل به Skills تبدیل شدند

    این رفتار عمدی است. فرمان‌های Claude به‌دست کاربر اجرا می‌شوند، بنابراین OpenClaw آن‌ها را به‌صورت Skills با disable-model-invocation: true وارد می‌کند. اگر می‌خواهید عامل آن‌ها را به‌طور خودکار فراخوانی کند، frontmatter هر Skill را ویرایش کنید.

    مطالب مرتبط

    Was this useful?
    On this page

    On this page