openclaw migrate

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

فرمان‌ها

openclaw migrate listopenclaw migrate claude --dry-runopenclaw migrate codex --dry-runopenclaw migrate codex --skill gog-vault77-google-workspaceopenclaw migrate codex --plugin google-calendar --dry-runopenclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-runopenclaw migrate hermes --dry-runopenclaw migrate hermesopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --plugin google-calendaropenclaw migrate apply codex --yesopenclaw migrate apply claude --yesopenclaw migrate apply hermes --yesopenclaw migrate apply hermes --include-secrets --yesopenclaw onboard --flow importopenclaw onboard --import-from claude --import-source ~/.claudeopenclaw onboard --import-from hermes --import-source ~/.hermes

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

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcGx1Z2luIDxuYW1l " type="string"> یک مورد نصب Plugin در Codex را بر اساس نام Plugin یا شناسه‌ی مورد انتخاب کنید. برای مهاجرت چند Plugin در Codex، پرچم را تکرار کنید. وقتی حذف شود، مهاجرت‌های تعاملی Codex یک انتخابگر بومی کادر تأیید Plugin در Codex نشان می‌دهند و مهاجرت‌های غیرتعاملی همه‌ی Pluginهای برنامه‌ریزی‌شده را نگه می‌دارند. این فقط برای Pluginهای Codex از نوع openai-curated که در مبدأ نصب شده‌اند و توسط موجودی app-server کدکس کشف شده‌اند اعمال می‌شود.

مدل ایمنی

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.
• دایرکتوری‌های Skills در Claude که شامل SKILL.md هستند.
• فایل‌های Markdown فرمان Claude که فقط با فراخوانی دستی به Skills در OpenClaw تبدیل می‌شوند.

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

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

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

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

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

اجرای openclaw migrate codex در یک ترمینال تعاملی، کل برنامه را پیش‌نمایش می‌کند، سپس پیش از تأیید نهایی apply، انتخابگرهای کادر تأیید را باز می‌کند. موارد کپی Skills ابتدا پرسیده می‌شوند. برای انتخاب انبوه از Toggle all on یا Toggle all off استفاده کنید. برای تغییر وضعیت ردیف‌ها Space را فشار دهید، یا برای فعال کردن ردیف برجسته‌شده و ادامه دادن Enter را فشار دهید. Skills برنامه‌ریزی‌شده از ابتدا انتخاب‌شده‌اند، Skills دارای تعارض از ابتدا انتخاب‌نشده‌اند، و Skip for now کپی‌های Skills را برای این اجرا رد می‌کند، در حالی که همچنان به انتخاب Plugin ادامه می‌دهد. وقتی Pluginهای Codex گزینش‌شده‌ی نصب‌شده در مبدأ قابل مهاجرت باشند و --plugin ارائه نشده باشد، مهاجرت سپس برای فعال‌سازی Plugin بومی Codex بر اساس نام Plugin درخواست می‌دهد. موارد Plugin از ابتدا انتخاب‌شده‌اند مگر اینکه پیکربندی Plugin هدف OpenClaw Codex از قبل آن Plugin را داشته باشد. Pluginهای موجود در هدف از ابتدا انتخاب‌نشده‌اند و یک راهنمای تعارض مانند conflict: plugin exists نشان می‌دهند؛ برای مهاجرت ندادن هیچ Plugin بومی Codex در آن اجرا، Toggle all off را انتخاب کنید، یا برای توقف پیش از apply، Skip for now را انتخاب کنید. برای اجراهای اسکریپتی یا دقیق، --skill <name> را یک بار برای هر Skills پاس دهید، برای مثال:

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

از --plugin <name> برای محدود کردن غیرتعاملی مهاجرت Plugin بومی Codex به یک یا چند Plugin گزینش‌شده‌ی نصب‌شده در مبدأ استفاده کنید:

openclaw migrate codex --dry-run --plugin google-calendaropenclaw migrate apply codex --yes --plugin google-calendar

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

• دایرکتوری‌های Skills در Codex CLI زیر $CODEX_HOME/skills، به‌جز کش .system در Codex.
• AgentSkills شخصی زیر $HOME/.agents/skills که وقتی مالکیت برای هر عامل را می‌خواهید، به فضای کاری عامل فعلی OpenClaw کپی می‌شوند.
• Pluginهای Codex از نوع openai-curated که در مبدأ نصب شده‌اند و از طریق plugin/list در app-server کدکس کشف می‌شوند. برنامه‌ریزی برای هر Plugin نصب‌شده‌ی فعال، plugin/read را می‌خواند. Pluginهای مبتنی بر app نیاز دارند پاسخ حساب app-server مبدأ Codex یک حساب اشتراک ChatGPT باشد؛ پاسخ‌های حساب غیر ChatGPT یا مفقود با codex_subscription_required رد می‌شوند. به‌طور پیش‌فرض، مهاجرت app/list مبدأ را فراخوانی نمی‌کند، بنابراین Pluginهای مبتنی بر app که از دروازه‌ی حساب عبور می‌کنند، بدون تأیید دسترسی‌پذیری app در مبدأ برنامه‌ریزی می‌شوند، و شکست‌های انتقال در جست‌وجوی حساب با codex_account_unavailable رد می‌شوند. وقتی می‌خواهید مهاجرت یک عکس فوری تازه از app/list مبدأ را اجبار کند و پیش از برنامه‌ریزی فعال‌سازی بومی، همه‌ی appهای تحت مالکیت حاضر، فعال، و قابل دسترسی باشند، --verify-plugin-apps را پاس دهید. در آن حالت، شکست‌های انتقال در جست‌وجوی حساب به تأیید موجودی app مبدأ واگذار می‌شوند. عکس فوری موجودی app مبدأ برای فرایند فعلی در حافظه نگه داشته می‌شود؛ در خروجی مهاجرت یا پیکربندی هدف نوشته نمی‌شود. Pluginهای غیرفعال، جزئیات Plugin خوانده‌نشدنی، حساب‌های مبدأ محدودشده به اشتراک، و، وقتی تأیید درخواست شده باشد، appهای مفقود، appهای غیرفعال، appهای غیرقابل دسترسی، یا شکست‌های موجودی app مبدأ به‌جای ورودی‌های پیکربندی هدف، به موارد دستی ردشده با دلایل نوع‌دار تبدیل می‌شوند. Apply برای هر Plugin واجد شرایطِ انتخاب‌شده plugin/install در app-server را فراخوانی می‌کند، حتی اگر app-server هدف از قبل آن Plugin را نصب‌شده و فعال گزارش کند. Pluginهای مهاجرت‌یافته‌ی Codex فقط در نشست‌هایی قابل استفاده‌اند که هارنس بومی Codex را انتخاب می‌کنند؛ آن‌ها در معرض Pi، اجراهای عادی ارائه‌دهنده‌ی OpenAI، پیوندهای مکالمه‌ی ACP، یا هارنس‌های دیگر قرار نمی‌گیرند.

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

config.toml در Codex، hooks/hooks.json بومی، بازارچه‌های غیرگزینش‌شده، بسته‌های Plugin کش‌شده که Pluginهای گزینش‌شده‌ی نصب‌شده در مبدأ نیستند، و Pluginهای نصب‌شده در مبدأ که دروازه‌ی اشتراک مبدأ را پاس نمی‌کنند، به‌طور خودکار فعال نمی‌شوند. وقتی --verify-plugin-apps تنظیم شده باشد، Pluginهایی که دروازه‌ی موجودی app مبدأ را پاس نمی‌کنند نیز رد می‌شوند. آن‌ها برای بازبینی دستی در گزارش مهاجرت کپی یا گزارش می‌شوند.

برای Pluginهای گزینش‌شده‌ی نصب‌شده در مبدأ که مهاجرت شده‌اند، apply می‌نویسد:

• plugins.entries.codex.enabled: true
• plugins.entries.codex.config.codexPlugins.enabled: true
• plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true
• یک ورودی صریح Plugin با marketplaceName: "openai-curated" و pluginName برای هر Plugin انتخاب‌شده

مهاجرت هرگز plugins["*"] را نمی‌نویسد و هرگز مسیرهای کش بازارچه‌ی محلی را ذخیره نمی‌کند. شکست‌های اشتراک در سمت مبدأ روی موارد دستی با دلایل نوع‌دار مانند codex_subscription_required، codex_account_unavailable، plugin_disabled، یا plugin_read_unavailable گزارش می‌شوند. با --verify-plugin-apps، شکست‌های موجودی app مبدأ می‌توانند به‌صورت app_inaccessible، app_disabled، app_missing، یا app_inventory_unavailable نیز ظاهر شوند. Pluginهای ردشده در پیکربندی هدف نوشته نمی‌شوند. نصب‌های سمت هدف که به احراز هویت نیاز دارند، روی مورد Plugin متأثر با status: "skipped"، reason: "auth_required"، و شناسه‌های app پاک‌سازی‌شده گزارش می‌شوند. ورودی‌های پیکربندی صریح آن‌ها تا زمانی که دوباره مجوزدهی و فعالشان کنید، به‌صورت غیرفعال نوشته می‌شوند. شکست‌های نصب دیگر، نتایج error محدود به همان مورد هستند.

اگر موجودی Plugin در app-server کدکس هنگام برنامه‌ریزی در دسترس نباشد، مهاجرت به‌جای شکست دادن کل مهاجرت، به موارد مشاوره‌ای بسته‌ی کش‌شده برمی‌گردد.

ارائه‌دهنده‌ی 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>/ هستند.
• مقادیر پیکربندی مختص هر Skill از 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: بررسی سلامت پس از اعمال یک مهاجرت.
• Plugins: نصب و ثبت plugin.