Maintenance
مهاجرت از Hermes
OpenClaw وضعیت Hermes را از طریق یک ارائهدهندهٔ مهاجرت همراه وارد میکند. این ارائهدهنده پیش از تغییر وضعیت، همهچیز را پیشنمایش میدهد، رازها را در طرحها و گزارشها پنهانسازی میکند، و پیش از اعمال، یک نسخهٔ پشتیبان تأییدشده میسازد.
دو روش برای واردسازی
جادوگر راهاندازی اولیه
سریعترین مسیر. جادوگر Hermes را در ~/.hermes شناسایی میکند و پیش از اعمال، یک پیشنمایش نشان میدهد.
openclaw onboard --flow importیا به یک مبدأ مشخص اشاره کنید:
openclaw onboard --import-from hermes --import-source ~/.hermesCLI
برای اجراهای اسکریپتی یا تکرارپذیر از openclaw migrate استفاده کنید. برای مرجع کامل، openclaw migrate را ببینید.
openclaw migrate hermes --dry-run # preview onlyopenclaw migrate apply hermes --yes # apply with confirmation skippedوقتی 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 تعاملی پیش از وارد کردن اعتبارنامههای احراز هویت سؤال میپرسد و پاسخ بله بهصورت پیشفرض انتخاب شده است. واردسازیهای پذیرفتهشده شامل اعتبارنامههای OpenAI OAuth متعلق به OpenCode از auth.json در OpenCode، ورودیهای OpenCode و GitHub Copilot از auth.json در OpenCode، و کلیدهای پشتیبانیشدهٔ .env هستند. ورودیهای OAuth در auth.json متعلق به Hermes وضعیت قدیمی محسوب میشوند و بهجای وارد شدن به احراز هویت زنده، بهعنوان کار نیازمند احراز هویت دوبارهٔ دستی/doctor نمایش داده میشوند. برای واردسازی غیرتعاملی اعتبارنامه با openclaw migrate از --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 واردشدهٔ شما بارگذاری شدهاند.
مدیریت تعارض
وقتی طرح تعارض گزارش میکند، اعمال از ادامه دادن خودداری میکند (یک فایل یا مقدار پیکربندی از قبل در مقصد وجود دارد).
در یک نصب تازهٔ OpenClaw، تعارضها غیرمعمولاند. آنها معمولاً وقتی ظاهر میشوند که واردسازی را روی راهاندازیای دوباره اجرا کنید که از قبل ویرایشهای کاربر دارد.
اگر تعارضی در میانهٔ اعمال رخ دهد (برای مثال، یک رقابت غیرمنتظره روی فایل پیکربندی)، Hermes موردهای پیکربندی وابستهٔ باقیمانده را بهجای نوشتن ناقص، با دلیل blocked by earlier apply conflict بهعنوان skipped علامتگذاری میکند. گزارش مهاجرت هر مورد مسدودشده را ثبت میکند تا بتوانید تعارض اصلی را حل کنید و واردسازی را دوباره اجرا کنید.
رازها
openclaw migrate تعاملی میپرسد آیا اعتبارنامههای احراز هویت شناساییشده وارد شوند یا نه، و پاسخ بله بهصورت پیشفرض انتخاب شده است.
- پذیرفتن درخواست، اعتبارنامههای OpenAI OAuth متعلق به OpenCode از
auth.jsonدر OpenCode، ورودیهای OpenCode و GitHub Copilot ازauth.jsonدر OpenCode، و کلیدهای پشتیبانیشدهٔ.envرا وارد میکند. ورودیهای OAuth درauth.jsonمتعلق به Hermes برای احراز هویت دوبارهٔ دستی OpenAI یا ترمیم doctor گزارش میشوند. - برای وارد کردن فقط وضعیت غیرمحرمانه، از
--no-auth-credentialsاستفاده کنید یا در درخواست، گزینهٔ نه را انتخاب کنید. - هنگام اجرای بدون نظارت همراه با
--yesاز--include-secretsاستفاده کنید. - هنگام وارد کردن اعتبارنامهها از جادوگر راهاندازی اولیه، از
--import-secretsاستفاده کنید. - برای اعتبارنامههای مدیریتشده با SecretRef، پس از تکمیل واردسازی، مبدأ SecretRef را پیکربندی کنید.
خروجی 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و فایلهای حافظه قرار دارند.
