# openclaw migrate

وضعیت را از یک سامانه عامل دیگر از طریق ارائه‌دهنده مهاجرت متعلق به Plugin وارد کنید. ارائه‌دهنده‌های همراه، وضعیت Codex CLI، Claude، و Hermes را پوشش می‌دهند؛ Pluginهای شخص ثالث می‌توانند ارائه‌دهنده‌های بیشتری ثبت کنند.

# فرمان‌ها

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> نام یک ارائه‌دهنده مهاجرت ثبت‌شده، برای مثال hermes. برای دیدن ارائه‌دهنده‌های نصب‌شده openclaw migrate list را اجرا کنید.

--dry-runboolean

طرح را بسازید و بدون تغییر دادن وضعیت خارج شوید.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> پوشه وضعیت مبدا را بازنویسی کنید. مقدار پیش‌فرض Hermes برابر ~/.hermes است.

--include-secretsboolean

اعتبارنامه‌های پشتیبانی‌شده را وارد کنید. به‌طور پیش‌فرض خاموش است.

--overwriteboolean

وقتی طرح تعارض گزارش می‌کند، به اعمال اجازه دهید هدف‌های موجود را جایگزین کند.

--yesboolean

اعلان تایید را رد کنید. در حالت غیرتعاملی الزامی است.

"--skill

--no-backupboolean

پشتیبان پیش از اعمال را رد کنید. وقتی وضعیت محلی OpenClaw وجود دارد، به --force نیاز دارد.

--forceboolean

وقتی اعمال در غیر این صورت از رد کردن پشتیبان خودداری می‌کند، همراه با --no-backup الزامی است.

--jsonboolean

طرح یا نتیجه اعمال را به‌صورت JSON چاپ کنید. با --json و بدون --yes، اعمال طرح را چاپ می‌کند و وضعیت را تغییر نمی‌دهد.

# مدل ایمنی

openclaw migrate ابتدا پیش‌نمایش می‌دهد.

# ارائه‌دهنده Claude

ارائه‌دهنده همراه Claude به‌طور پیش‌فرض وضعیت Claude Code را در ~/.claude تشخیص می‌دهد. برای وارد کردن یک خانه Claude Code یا ریشه پروژه مشخص از --from <path> استفاده کنید.

# Claude چه چیزهایی وارد می‌کند

• CLAUDE.md پروژه و .claude/CLAUDE.md به فضای کاری عامل OpenClaw.
• ~/.claude/CLAUDE.md کاربر که به USER.md فضای کاری افزوده می‌شود.
• تعریف‌های سرور MCP از .mcp.json پروژه، ~/.claude.json متعلق به Claude Code، و claude_desktop_config.json متعلق به Claude Desktop.
• پوشه‌های مهارت Claude که شامل SKILL.md هستند.
• فایل‌های Markdown فرمان Claude که فقط با فراخوانی دستی به مهارت‌های OpenClaw تبدیل می‌شوند.

# وضعیت بایگانی و بازبینی دستی

قلاب‌ها، مجوزها، پیش‌فرض‌های محیط، حافظه محلی، قوانین محدود به مسیر، زیردستیارها، کش‌ها، طرح‌ها، و تاریخچه پروژه Claude در گزارش مهاجرت حفظ می‌شوند یا به‌عنوان موارد نیازمند بازبینی دستی گزارش می‌شوند. OpenClaw قلاب‌ها را اجرا نمی‌کند، فهرست‌های مجاز گسترده را کپی نمی‌کند، و وضعیت اعتبارنامه OAuth/Desktop را به‌طور خودکار وارد نمی‌کند.

# ارائه‌دهنده Codex

ارائه‌دهنده همراه Codex به‌طور پیش‌فرض وضعیت Codex CLI را در ~/.codex تشخیص می‌دهد، یا وقتی متغیر محیطی CODEX_HOME تنظیم شده باشد در CODEX_HOME. برای فهرست‌برداری از یک خانه Codex مشخص از --from <path> استفاده کنید.

وقتی به مهار Codex در OpenClaw منتقل می‌شوید و می‌خواهید دارایی‌های شخصی مفید Codex CLI را آگاهانه ارتقا دهید، از این ارائه‌دهنده استفاده کنید. اجراهای محلی کارساز برنامه Codex از پوشه‌های CODEX_HOME و HOME مختص هر عامل استفاده می‌کنند، بنابراین به‌طور پیش‌فرض وضعیت شخصی Codex CLI شما را نمی‌خوانند.

اجرای openclaw migrate codex در یک پایانه تعاملی، طرح کامل را پیش‌نمایش می‌کند، سپس پیش از تایید نهایی اعمال، یک انتخابگر کادر انتخاب برای موارد کپی مهارت باز می‌کند. برای انتخاب گروهی از Toggle all on یا Toggle all off استفاده کنید؛ مهارت‌های برنامه‌ریزی‌شده به‌صورت انتخاب‌شده شروع می‌شوند، مهارت‌های دارای تعارض به‌صورت انتخاب‌نشده شروع می‌شوند، و Skip for now مهارت‌ها را بدون اعمال، بدون تغییر باقی می‌گذارد. برای اجراهای اسکریپتی یا دقیق، برای هر مهارت یک بار --skill <name> را پاس دهید، برای مثال:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

# Codex چه چیزهایی وارد می‌کند

• پوشه‌های مهارت Codex CLI زیر $CODEX_HOME/skills، به‌جز کش .system متعلق به Codex.
• AgentSkills شخصی زیر $HOME/.agents/skills، که وقتی مالکیت مختص هر عامل را می‌خواهید، به فضای کاری عامل فعلی OpenClaw کپی می‌شود.

# وضعیت Codex نیازمند بازبینی دستی

Pluginهای بومی Codex، config.toml، و hooks/hooks.json بومی به‌طور خودکار فعال نمی‌شوند. Pluginها ممکن است سرورهای MCP، برنامه‌ها، قلاب‌ها، یا رفتار اجرایی دیگری را در معرض قرار دهند، بنابراین ارائه‌دهنده آن‌ها را به‌جای بارگذاری در OpenClaw برای بازبینی گزارش می‌کند. فایل‌های پیکربندی و قلاب برای بازبینی دستی در گزارش مهاجرت کپی می‌شوند.

# ارائه‌دهنده Hermes

ارائه‌دهنده همراه Hermes به‌طور پیش‌فرض وضعیت را در ~/.hermes تشخیص می‌دهد. وقتی Hermes جای دیگری قرار دارد، از --from <path> استفاده کنید.

# Hermes چه چیزهایی وارد می‌کند

• پیکربندی مدل پیش‌فرض از config.yaml.
• ارائه‌دهنده‌های مدل پیکربندی‌شده و نقاط پایانی سفارشی سازگار با OpenAI از providers و custom_providers.
• تعریف‌های سرور MCP از mcp_servers یا mcp.servers.
• SOUL.md و AGENTS.md به فضای کاری عامل OpenClaw.
• memories/MEMORY.md و memories/USER.md که به فایل‌های حافظه فضای کاری افزوده می‌شوند.
• پیش‌فرض‌های پیکربندی حافظه برای حافظه فایلی OpenClaw، به‌علاوه موارد بایگانی یا بازبینی دستی برای ارائه‌دهنده‌های حافظه خارجی مانند Honcho.
• Skills که شامل فایل SKILL.md زیر skills/<name>/ هستند.
• مقدارهای پیکربندی مختص هر مهارت از skills.config.
• کلیدهای API پشتیبانی‌شده از .env، فقط با --include-secrets.

# کلیدهای .env پشتیبانی‌شده

OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY.

# وضعیت فقط بایگانی

وضعیت Hermes که OpenClaw نمی‌تواند با اطمینان تفسیر کند برای بازبینی دستی در گزارش مهاجرت کپی می‌شود، اما در پیکربندی زنده یا اعتبارنامه‌های OpenClaw بارگذاری نمی‌شود. این کار وضعیت مبهم یا ناامن را بدون وانمود کردن به اینکه OpenClaw می‌تواند آن را به‌طور خودکار اجرا کند یا به آن اعتماد کند حفظ می‌کند:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• auth.json
• state.db

# پس از اعمال

openclaw doctor

# قرارداد Plugin

منابع مهاجرت Pluginها هستند. یک Plugin شناسه‌های ارائه‌دهنده خود را در openclaw.plugin.json اعلام می‌کند:

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

در زمان اجرا، Plugin تابع api.registerMigrationProvider(...) را فراخوانی می‌کند. ارائه‌دهنده detect، plan، و apply را پیاده‌سازی می‌کند. هسته مالک هماهنگ‌سازی CLI، سیاست پشتیبان، اعلان‌ها، خروجی JSON، و پیش‌پرواز تعارض است. هسته طرح بازبینی‌شده را به apply(ctx, plan) پاس می‌دهد، و ارائه‌دهنده‌ها فقط وقتی آن آرگومان برای سازگاری غایب باشد ممکن است طرح را دوباره بسازند.

Pluginهای ارائه‌دهنده می‌توانند از openclaw/plugin-sdk/migration برای ساخت موردها و شمارش‌های خلاصه استفاده کنند، به‌علاوه از openclaw/plugin-sdk/migration-runtime برای کپی‌های فایل آگاه از تعارض، کپی‌های گزارش فقط بایگانی، پوشش‌دهنده‌های کش‌شده config-runtime، و گزارش‌های مهاجرت.

# یکپارچه‌سازی راه‌اندازی اولیه

وقتی یک ارائه‌دهنده منبع شناخته‌شده‌ای را تشخیص می‌دهد، راه‌اندازی اولیه می‌تواند مهاجرت را پیشنهاد دهد. هر دو openclaw onboard --flow import و openclaw setup --wizard --import-from hermes از همان ارائه‌دهنده مهاجرت Plugin استفاده می‌کنند و همچنان پیش از اعمال، پیش‌نمایش نشان می‌دهند.

# مرتبط

• مهاجرت از Hermes: راهنمای کاربرمحور.
• مهاجرت از Claude: راهنمای کاربرمحور.
• مهاجرت: انتقال OpenClaw به یک دستگاه جدید.
• Doctor: بررسی سلامت پس از اعمال یک مهاجرت.
• Pluginها: نصب و ثبت Plugin.