Maintenance
راهنمای مهاجرت
OpenClaw از سه مسیر مهاجرت پشتیبانی میکند: واردکردن از یک سامانه عامل دیگر، انتقال نصب موجود به یک دستگاه جدید، و ارتقای درجا یک Plugin.
واردکردن از یک سامانه عامل دیگر
ارائهدهندگان مهاجرت همراه، دستورالعملها، سرورهای MCP، مهارتها، پیکربندی مدل و کلیدهای API (بهصورت اختیاری) را به OpenClaw منتقل میکنند. پیش از هر تغییری، پیشنمایش طرحها نمایش داده میشود و اطلاعات محرمانه در گزارشها پوشانده میشوند. openclaw migrate مستقل به یک نسخه پشتیبان تأییدشده متکی است؛ در عوض، راهاندازی اولیه جدید، مصنوعات محلی را پیش از انتشار آماده و تأیید میکند و پیکربندی را پیش از هرگونه فعالسازی خارجی برگشتناپذیر ثبت میکند.
وضعیت Claude Code و Claude Desktop، از جمله CLAUDE.md، سرورهای MCP، مهارتها و فرمانهای پروژه را وارد کنید.
پیکربندی Hermes، ارائهدهندگان، سرورهای MCP، حافظه، مهارتها و کلیدهای پشتیبانیشده .env را وارد کنید.
نقطه ورود CLI، openclaw migrate است. راهاندازی اولیه نیز میتواند هنگام شناسایی یک منبع شناختهشده (openclaw onboard --flow import) مهاجرت را پیشنهاد دهد.
انتقال OpenClaw به یک دستگاه جدید
برای حفظ موارد زیر، دایرکتوری وضعیت (بهطور پیشفرض ~/.openclaw/) و فضای کاری خود را کپی کنید:
- پیکربندی —
openclaw.jsonو همه تنظیمات Gateway. - احراز هویت —
auth-profiles.jsonمختص هر عامل (کلیدهای API بههمراه OAuth) و هرگونه وضعیت کانال یا ارائهدهنده درcredentials/. - نشستها — تاریخچه مکالمه و وضعیت عامل.
- وضعیت کانال — ورود WhatsApp، نشست Telegram و موارد مشابه.
- فایلهای فضای کاری —
MEMORY.md،USER.md، مهارتها و پرامپتها.
مراحل مهاجرت
توقف Gateway و تهیه نسخه پشتیبان
در دستگاه قدیمی، Gateway را متوقف کنید تا فایلها هنگام کپی تغییر نکنند، سپس بایگانی تهیه کنید:
openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclawاگر از چند پروفایل استفاده میکنید (برای مثال ~/.openclaw-work)، هرکدام را جداگانه بایگانی کنید.
نصب OpenClaw روی دستگاه جدید
CLI (و در صورت نیاز Node) را روی دستگاه جدید نصب کنید. اگر راهاندازی اولیه یک ~/.openclaw/ جدید ایجاد کند، مشکلی نیست؛ در مرحله بعد آن را بازنویسی میکنید.
کپی دایرکتوری وضعیت و فضای کاری
بایگانی را از طریق scp، rsync -a یا یک درایو خارجی منتقل و سپس استخراج کنید:
cd ~tar -xzf openclaw-state.tgzتأیید کنید که دایرکتوریهای مخفی نیز گنجانده شدهاند و مالکیت فایلها با کاربری که Gateway را اجرا خواهد کرد مطابقت دارد.
اجرای Doctor و تأیید
در دستگاه جدید، برای اعمال مهاجرتهای پیکربندی و تعمیر سرویسها، Doctor را اجرا کنید:
openclaw doctoropenclaw gateway restartopenclaw statusاگر Telegram یا Discord از جایگزین پیشفرض متغیر محیطی (TELEGRAM_BOT_TOKEN یا DISCORD_BOT_TOKEN) استفاده میکند، بدون چاپ مقادیر محرمانه بررسی کنید که .env در دایرکتوری وضعیت مهاجرتدادهشده حاوی این کلیدها باشد:
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.envopenclaw doctor همچنین هنگامی هشدار میدهد که یک حساب پیشفرض فعال Telegram یا Discord توکن پیکربندیشدهای نداشته باشد و متغیر محیطی متناظر نیز در دسترس فرایند Doctor نباشد.
خطاهای رایج
عدم تطابق پروفایل یا دایرکتوری وضعیت
اگر Gateway قدیمی از --profile یا OPENCLAW_STATE_DIR استفاده میکرد اما نمونه جدید استفاده نمیکند، کانالها خارجشده از حساب به نظر میرسند و نشستها خالی خواهند بود. Gateway را با همان پروفایل یا دایرکتوری وضعیتی که مهاجرت دادهاید راهاندازی کنید، سپس openclaw doctor را دوباره اجرا کنید.
کپیکردن فقط openclaw.json
فایل پیکربندی بهتنهایی کافی نیست. پروفایلهای احراز هویت مدل در agents/<agentId>/agent/auth-profiles.json و وضعیت کانال و ارائهدهنده در credentials/ قرار دارند. همیشه کل دایرکتوری وضعیت را مهاجرت دهید.
مجوزها و مالکیت
اگر فایلها را با کاربر root کپی کردهاید یا کاربر را تغییر دادهاید، ممکن است Gateway نتواند اطلاعات اعتبارسنجی را بخواند. مطمئن شوید دایرکتوری وضعیت و فضای کاری متعلق به کاربری هستند که Gateway را اجرا میکند.
حالت راه دور
اگر رابط کاربری شما به یک Gateway راه دور متصل است، نشستها و فضای کاری متعلق به میزبان راه دور هستند. خود میزبان Gateway را مهاجرت دهید، نه لپتاپ محلی خود را. به پرسشهای متداول مراجعه کنید.
اطلاعات محرمانه در نسخههای پشتیبان
دایرکتوری وضعیت شامل پروفایلهای احراز هویت، اطلاعات اعتبارسنجی کانال و سایر وضعیتهای ارائهدهنده است. نسخههای پشتیبان را بهصورت رمزگذاریشده نگه دارید، از کانالهای انتقال ناامن اجتناب کنید و اگر به افشای اطلاعات مشکوک هستید، کلیدها را تعویض کنید.
فهرست بررسی تأیید
در دستگاه جدید، موارد زیر را تأیید کنید:
- [ ]
openclaw statusنشان میدهد Gateway در حال اجرا است. - [ ] کانالها همچنان متصل هستند (نیازی به جفتسازی مجدد نیست).
- [ ] داشبورد باز میشود و نشستهای موجود را نمایش میدهد.
- [ ] فایلهای فضای کاری (حافظه و پیکربندیها) موجود هستند.
ارتقای درجا یک Plugin
ارتقاهای درجای Plugin همان شناسه Plugin و کلیدهای پیکربندی را حفظ میکنند، اما ممکن است وضعیت ذخیرهشده روی دیسک را به چیدمان کنونی منتقل کنند. راهنماهای ارتقای مختص هر Plugin در کنار کانالهای مربوط به آن قرار دارند:
- مهاجرت Matrix: محدودیتهای بازیابی وضعیت رمزگذاریشده، رفتار عکس فوری خودکار و فرمانهای بازیابی دستی.
مرتبط
openclaw migrate: مرجع CLI برای واردکردن میان سامانهها.- نمای کلی نصب: همه روشهای نصب.
- Doctor: بررسی سلامت پس از مهاجرت.
- حذف نصب: حذف کامل OpenClaw.
