Maintenance
مهاجرت از Hermes
ارائهدهنده مهاجرت Hermes که همراه برنامه ارائه میشود، وضعیت را در ~/.hermes شناسایی میکند، پیش از اعمال هر تغییر پیشنمایش آن را نشان میدهد، اطلاعات محرمانه را در طرحها و گزارشها پوشیده میکند و پیش از دستزدن به هر چیزی، یک نسخه پشتیبان تأییدشده از OpenClaw مینویسد.
دو روش برای درونریزی
جادوگر راهاندازی اولیه
Hermes را در ~/.hermes شناسایی میکند و پیش از اعمال، پیشنمایشی نشان میدهد.
openclaw onboard --flow importیا یک منبع مشخص را تعیین کنید:
openclaw onboard --import-from hermes --import-source ~/.hermesCLI
برای اجراهای اسکریپتی یا تکرارپذیر از openclaw migrate استفاده کنید. برای مرجع کامل، به openclaw migrate مراجعه کنید.
openclaw migrate hermes --dry-run # فقط پیشنمایشopenclaw migrate apply hermes --yes # اعمال بدون درخواست تأییداگر Hermes خارج از ~/.hermes قرار دارد، --from <path> را اضافه کنید.
مواردی که درونریزی میشوند
پیکربندی مدل
- انتخاب مدل پیشفرض از
config.yamlدر Hermes. - ارائهدهندگان مدل پیکربندیشده و نقاط پایانی سفارشی سازگار با OpenAI از
providersوcustom_providers.
سرورهای MCP
تعریفهای سرور MCP از mcp_servers یا mcp.servers.
فایلهای فضای کاری
- فایلهای
SOUL.mdوAGENTS.mdدر فضای کاری عامل OpenClaw کپی میشوند. - فایلهای
memories/MEMORY.mdوmemories/USER.mdبهجای بازنویسی، به فایلهای حافظه متناظر OpenClaw افزوده میشوند.
پیکربندی حافظه
پیشفرضهای پیکربندی حافظه برای حافظه فایلی OpenClaw. ارائهدهندگان حافظه خارجی مانند Honcho بهعنوان موارد بایگانی یا نیازمند بررسی دستی ثبت میشوند تا بتوانید آنها را آگاهانه منتقل کنید.
Skills
Skills دارای فایل SKILL.md در مسیر skills/<name>/، همراه با مقادیر پیکربندی مختص هر Skill از skills.config کپی میشوند.
اعتبارنامههای احراز هویت
اجرای تعاملی openclaw migrate پیش از درونریزی اعتبارنامههای احراز هویت سؤال میکند و گزینه بله بهصورت پیشفرض انتخاب شده است. با پذیرش، ورودیهای OpenCode OpenAI OAuth و GitHub Copilot از auth.json متعلق به OpenCode، بههمراه کلیدهای پشتیبانیشده .env در Hermes درونریزی میشوند. ورودیهای OAuth در auth.json خود Hermes وضعیت قدیمی محسوب میشوند: این موارد بهجای درونریزی در احراز هویت فعال، بهعنوان موردی برای احراز هویت مجدد یا بررسی دستی با Doctor نمایش داده میشوند. برای درونریزی اعتبارنامهها در اجرای غیرتعاملی از --include-secrets، برای ردکردن کامل درونریزی اعتبارنامهها از --no-auth-credentials، یا در جادوگر راهاندازی اولیه از پرچم --import-secrets استفاده کنید.
مواردی که فقط در بایگانی باقی میمانند
ارائهدهنده این موارد را برای بررسی دستی در پوشه گزارش مهاجرت کپی میکند، اما آنها را در پیکربندی یا اعتبارنامههای فعال OpenClaw بارگذاری نمیکند:
plugins/sessions/logs/cron/mcp-tokens/state.db
OpenClaw از اجرای خودکار یا اعتماد به این وضعیت خودداری میکند، زیرا قالبها و فرضیات اعتماد ممکن است میان سامانهها تغییر کرده باشند. پس از بررسی بایگانی، موارد موردنیاز را بهصورت دستی منتقل کنید.
روند پیشنهادی
پیشنمایش طرح
openclaw migrate hermes --dry-runطرح همه مواردی را که تغییر خواهند کرد فهرست میکند؛ از جمله تداخلها، موارد ردشده و موارد حساس. کلیدهای تودرتویی که محرمانه به نظر میرسند در خروجی پوشیده میشوند.
اعمال همراه با نسخه پشتیبان
openclaw migrate apply hermes --yesOpenClaw پیش از اعمال، یک نسخه پشتیبان ایجاد و تأیید میکند. این نمونه غیرتعاملی فقط وضعیت غیرمحرمانه را درونریزی میکند. برای پاسخ تعاملی به درخواست اعتبارنامه، فرمان را بدون --yes اجرا کنید؛ یا برای دربرگرفتن اعتبارنامههای پشتیبانیشده در اجرای بدون نظارت، --include-secrets را اضافه کنید.
اجرای Doctor
openclaw doctorDoctor مهاجرتهای پیکربندی معلق را دوباره اعمال میکند و مشکلات ایجادشده هنگام درونریزی را بررسی میکند.
راهاندازی مجدد و تأیید
openclaw gateway restartopenclaw statusتأیید کنید که Gateway سالم است و مدل، حافظه و Skills درونریزیشده شما بارگذاری شدهاند.
مدیریت تداخلها
هنگامی که طرح تداخل گزارش میدهد ــ یعنی فایل یا مقدار پیکربندی از قبل در مقصد وجود دارد ــ عملیات اعمال از ادامه خودداری میکند.
تداخلها در نصب تازه غیرمعمولاند. آنها معمولاً زمانی ظاهر میشوند که درونریزی را دوباره روی راهاندازیای اجرا کنید که از قبل ویرایشهای کاربر را دارد.
اگر تداخلی هنگام اعمال ظاهر شود ــ برای مثال، رقابتی پیشبینینشده روی یک فایل پیکربندی ــ Hermes موارد پیکربندی وابسته باقیمانده را بهجای نوشتن ناقص، با وضعیت skipped و دلیل blocked by earlier apply conflict علامتگذاری میکند. گزارش مهاجرت هر مورد مسدودشده را ثبت میکند تا بتوانید تداخل اصلی را برطرف کرده و درونریزی را دوباره اجرا کنید.
اطلاعات محرمانه
اجرای تعاملی openclaw migrate میپرسد آیا اعتبارنامههای احراز هویت شناساییشده درونریزی شوند یا نه و گزینه بله بهصورت پیشفرض انتخاب شده است.
- با پذیرش، ورودیهای OpenCode OpenAI OAuth و GitHub Copilot از
auth.jsonمتعلق به OpenCode، بههمراه کلیدهای پشتیبانیشده.envدرونریزی میشوند. ورودیهای OAuth درauth.jsonخود Hermes در عوض برای احراز هویت مجدد دستی OpenAI یا ترمیم با Doctor گزارش میشوند. - برای درونریزی فقط وضعیت غیرمحرمانه، از
--no-auth-credentialsاستفاده کنید یا در درخواست پاسخ منفی دهید. - برای درونریزی اعتبارنامهها در اجرای بدون نظارت همراه با
--yes، از--include-secretsاستفاده کنید. - برای درونریزی اعتبارنامهها از طریق جادوگر راهاندازی اولیه، از پرچم
--import-secretsاستفاده کنید.
خروجی JSON برای خودکارسازی
openclaw migrate hermes --dry-run --jsonopenclaw migrate apply hermes --json --yesبا --json و بدون --yes، عملیات اعمال طرح را چاپ میکند و وضعیت را تغییر نمیدهد؛ این امنترین حالت برای CI و اسکریپتهای اشتراکی است.
عیبیابی
عملیات اعمال بهدلیل تداخلها از ادامه خودداری میکند
خروجی طرح را بررسی کنید. هر تداخل، مسیر منبع و مقصد موجود را مشخص میکند. برای هر مورد تصمیم بگیرید که آن را رد کنید، مقصد را ویرایش کنید یا با --overwrite دوباره اجرا کنید.
Hermes خارج از ~/.hermes قرار دارد
از --from /actual/path برای CLI یا --import-source /actual/path برای راهاندازی اولیه استفاده کنید.
راهاندازی اولیه از درونریزی روی راهاندازی موجود خودداری میکند
درونریزی از طریق راهاندازی اولیه به یک راهاندازی تازه نیاز دارد. یا وضعیت را بازنشانی کرده و راهاندازی اولیه را دوباره انجام دهید، یا مستقیماً از openclaw migrate apply hermes استفاده کنید که از --overwrite و کنترل صریح نسخه پشتیبان پشتیبانی میکند.
کلیدهای API درونریزی نشدند
اجرای تعاملی openclaw migrate فقط زمانی کلیدهای API را درونریزی میکند که درخواست اعتبارنامه را بپذیرید. اجراهای غیرتعاملی همراه با --yes به --include-secrets نیاز دارند؛ درونریزی از طریق راهاندازی اولیه نیز به --import-secrets نیاز دارد. فقط کلیدهای پشتیبانیشده .env شناسایی میشوند و سایر متغیرهای .env نادیده گرفته میشوند.
مرتبط
openclaw migrate: مرجع کامل CLI، قرارداد Plugin و ساختارهای JSON.- راهاندازی اولیه: روند جادوگر و پرچمهای غیرتعاملی.
- مهاجرت: انتقال نصب OpenClaw میان دستگاهها.
- Doctor: بررسی سلامت پس از مهاجرت.
- فضای کاری عامل: محل قرارگیری
SOUL.md،AGENTS.mdو فایلهای حافظه.
