Maintenance
مهاجرت از Hermes
ارائهدهندهٔ مهاجرت Hermes که همراه برنامه ارائه میشود، از HERMES_HOME و پروفایل فعال Hermes پیروی میکند و در صورت نبود آنها، در macOS/Linux به ~/.hermes یا در Windows به %LOCALAPPDATA%\hermes برمیگردد. این ارائهدهنده پیش از اعمال، همهٔ تغییرات را پیشنمایش میکند و رازها را در طرحها و گزارشها میپوشاند. اجرای مستقل openclaw migrate یک نسخهٔ پشتیبان تأییدشده مینویسد؛ مسیر راهاندازی اولیهٔ تازه، پیکربندی، اعتبارنامهها و فایلها را مرحلهبندی میکند و فقط پس از تأیید استنتاج واردشده، آنها را منتشر میکند. مسیر صریح --from همیشه اولویت دارد.
دو روش برای واردکردن
جادوگر راهاندازی اولیه
خانه/پروفایل فعال 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، --from <path> را اضافه کنید.
چه چیزهایی وارد میشوند
پیکربندی مدل
- انتخاب مدل پیشفرض از
config.yamlدر Hermes. - ارائهدهندگان مدل پیکربندیشده و نقاط پایانی سفارشی از
model،providersوcustom_providers، شامل انتقالهای کنونی Chat Completions، Codex Responses و Anthropic Messages در Hermes.
سرورهای MCP
تعریفهای سرور MCP از mcp_servers یا mcp.servers، شامل وضعیت غیرفعال، مهلتهای زمانی، پشتیبانی از ابزارهای موازی، دامنهٔ OAuth، فیلدهای سازگار TLS و خطمشی ابزارهای بومی/منبع/پرامپت. متغیرهای محیطی و سرآیندهای صریح به رضایت برای واردکردن اعتبارنامه نیاز دارند. تنظیمات مختص Hermes برای چرخهٔ حیات، نمونهبرداری، درخواست اطلاعات، بررسی پیشنیاز، زندهنگهداشتن، بستهٔ CA، کلید کارخواه محافظتشده با گذرواژه و کارخواه OAuth ازپیشثبتشده، بهجای تبدیلشدن به پیکربندی نامعتبر OpenClaw، به موارد نیازمند بازبینی دستی تبدیل میشوند.
فایلهای فضای کاری
SOUL.mdوAGENTS.mdدر فضای کاری عامل OpenClaw کپی میشوند.memories/MEMORY.mdوmemories/USER.mdبهجای بازنویسی فایلهای حافظهٔ متناظر OpenClaw، به آنها افزوده میشوند.- سطوح مختص حافظه رفتار متفاوتی دارند: صفحهٔ حافظهٔ راهاندازی اولیه و صفحهٔ واردکردن حافظه در رابط کنترل، این دو فایل را برای بازیابی نمایهشده زیر
memory/imports/hermes/کپی میکنند و حافظهٔ موجود فضای کاری را دستنخورده باقی میگذارند.
پیکربندی حافظه
پیشفرضهای پیکربندی حافظه برای حافظهٔ فایلی OpenClaw. ارائهدهندگان حافظهٔ خارجی مانند Honcho بهعنوان موارد بایگانی یا نیازمند بازبینی دستی ثبت میشوند تا بتوانید آنها را آگاهانه منتقل کنید.
Skills
Skills دارای فایل SKILL.md در هر نقطهای زیر skills/ بهصورت بازگشتی شناسایی میشوند، در پوشهٔ Skill فضای کاری OpenClaw به ساختاری مسطح تبدیل میشوند و همراه با فایلهای پشتیبانشان کپی میشوند. مقادیر پیکربندی هر Skill از skills.config حفظ میشوند.
اعتبارنامههای احراز هویت
اجرای تعاملی openclaw migrate پیش از واردکردن اعتبارنامههای احراز هویت پرسش میکند و گزینهٔ بله بهطور پیشفرض انتخاب شده است. واردکردنهای پذیرفتهشده شامل ورودیهای فعلی OpenAI Codex OAuth در Hermes، ورودیهای OpenAI OAuth و GitHub Copilot در OpenCode و کلیدهای پشتیبانیشدهٔ .env در Hermes است. برای واردکردن غیرتعاملی از --include-secrets، برای ردکردن اعتبارنامهها از --no-auth-credentials یا از پرچم --import-secrets راهاندازی اولیه استفاده کنید. پس از واردکردن OAuth از Hermes، نگذارید Hermes و OpenClaw از یک مجوز نوسازی مشترک استفاده کنند؛ پیش از اجرای همزمان هر دو، احراز هویت یکی را دوباره انجام دهید.
چه چیزهایی فقط در بایگانی باقی میمانند
ارائهدهنده موارد زیر را برای بازبینی دستی در پوشهٔ گزارش مهاجرت کپی میکند، اما آنها را در پیکربندی یا اعتبارنامههای فعال OpenClaw بارگذاری نمیکند:
plugins/sessions/logs/cron/mcp-tokens/plans/،workspace/،skins/وkanban/- ذخیرههای
pairing/وplatforms/، بههمراه وضعیت مسیریابی/فرایند Gateway state.db،hermes_state.db،projects.db،response_store.db،memory_store.db،verification_evidence.db،kanban.dbوretaindb_queue.db
OpenClaw از اجرای خودکار یا اعتماد خودکار به این وضعیت خودداری میکند، زیرا قالبها و فرضهای اعتماد ممکن است میان سامانهها تغییر کنند. پس از بازبینی بایگانی، موارد موردنیاز را بهصورت دستی منتقل کنید.
روند پیشنهادی
پیشنمایش طرح
openclaw migrate hermes --dry-runطرح همهٔ مواردی را که تغییر خواهند کرد، از جمله تعارضها، موارد ردشده و موارد حساس، فهرست میکند. کلیدهای تودرتویی که شبیه راز هستند در خروجی پوشانده میشوند.
اعمال همراه با نسخهٔ پشتیبان
openclaw migrate apply hermes --yesOpenClaw پیش از اعمال، یک نسخهٔ پشتیبان ایجاد و تأیید میکند. این نمونهٔ غیرتعاملی فقط وضعیت غیرمحرمانه را وارد میکند. برای پاسخ تعاملی به پرسش اعتبارنامه، بدون --yes اجرا کنید، یا برای افزودن اعتبارنامههای پشتیبانیشده در اجرای بدون نظارت، --include-secrets را اضافه کنید.
اجرای Doctor
openclaw doctorDoctor همهٔ مهاجرتهای معلق پیکربندی را دوباره اعمال میکند و مشکلات ایجادشده هنگام واردکردن را بررسی میکند.
راهاندازی مجدد و تأیید
openclaw gateway restartopenclaw statusتأیید کنید Gateway سالم است و مدل، حافظه و Skills واردشدهٔ شما بارگذاری شدهاند.
مدیریت تعارض
وقتی طرح تعارضهایی را گزارش میکند (یک فایل یا مقدار پیکربندی از قبل در مقصد وجود دارد)، عملیات اعمال از ادامه خودداری میکند.
تعارضها در نصب تازه نامعمولاند. معمولاً زمانی ظاهر میشوند که واردکردن را دوباره روی راهاندازیای اجرا کنید که از قبل ویرایشهای کاربر را دارد.
اگر در میانهٔ اعمال تعارضی رخ دهد (برای مثال، رقابت غیرمنتظره روی یک فایل پیکربندی)، آن مورد بهعنوان تعارض گزارش میشود و فایلها، Skills، اعتبارنامهها، بایگانیها و ورودیهای پیکربندی مستقل به کار ادامه میدهند. مورد متعارض را رفع کنید و واردکردن را دوباره اجرا کنید؛ واردکردن حافظههای یکسان idempotent است.
رازها
اجرای تعاملی openclaw migrate میپرسد آیا اعتبارنامههای احراز هویت شناساییشده وارد شوند یا نه و گزینهٔ بله بهطور پیشفرض انتخاب شده است.
- پذیرش، ورودیهای فعلی OpenAI Codex OAuth در Hermes، ورودیهای OpenAI OAuth و GitHub Copilot در OpenCode و کلیدهای پشتیبانیشدهٔ
.envرا وارد میکند. - برای واردکردن فقط وضعیت غیرمحرمانه، از
--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و فایلهای حافظه.
