English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

Посібник із міграції

OpenClaw підтримує три шляхи міграції: імпорт з іншої агентної системи, перенесення наявного встановлення на нову машину та оновлення Plugin на місці.

Імпорт з іншої агентної системи

Використовуйте вбудовані постачальники міграції, щоб перенести інструкції, сервери MCP, Skills, конфігурацію моделі та (за згодою) ключі API до OpenClaw. Плани попередньо показуються перед будь-якою зміною, секрети редагуються у звітах, а застосування підкріплене перевіреною резервною копією.

Міграція з Claude

Імпортуйте стан Claude Code і Claude Desktop, зокрема CLAUDE.md, сервери MCP, Skills і команди проєкту.
Міграція з Hermes

Імпортуйте конфігурацію Hermes, постачальників, сервери MCP, пам’ять, Skills і підтримувані ключі .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, Skills і промпти.

Кроки міграції

  • Зупиніть Gateway і створіть резервну копію

    На старій машині зупиніть Gateway, щоб файли не змінювалися під час копіювання, а потім створіть архів:

    openclaw gateway stop
cd ~
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 doctor
openclaw gateway restart
openclaw status

    • Якщо Telegram або Discord використовує стандартний резервний варіант через env (TELEGRAM_BOT_TOKEN або DISCORD_BOT_TOKEN), перевірте, що перенесений .env у каталозі стану містить ці ключі, не виводячи секретні значення:

    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    openclaw doctor також попереджає, коли ввімкнений стандартний обліковий запис Telegram або Discord не має налаштованого токена, а відповідна змінна env недоступна процесу doctor.

    Поширені пастки

    Невідповідність профілю або каталогу стану

    Якщо старий Gateway використовував --profile або OPENCLAW_STATE_DIR, а новий — ні, канали виглядатимуть розлогіненими, а сесії будуть порожніми. Запустіть Gateway із тим самим профілем або каталогом стану, який ви перенесли, а потім повторно запустіть openclaw doctor.

    Копіювання лише openclaw.json

    Самого файлу конфігурації недостатньо. Профілі автентифікації моделей зберігаються в agents/<agentId>/agent/auth-profiles.json, а стан каналів і постачальників — у credentials/. Завжди мігруйте весь каталог стану.

    Дозволи та власник

    Якщо ви копіювали від root або змінили користувача, Gateway може не змогти прочитати облікові дані. Переконайтеся, що каталог стану й робочий простір належать користувачу, який запускає Gateway.

    Віддалений режим

    Якщо ваш UI вказує на віддалений Gateway, сесіями та робочим простором володіє віддалений хост. Мігруйте сам хост Gateway, а не свій локальний ноутбук. Див. FAQ.

    Секрети в резервних копіях

    Каталог стану містить профілі автентифікації, облікові дані каналів та інший стан постачальників. Зберігайте резервні копії зашифрованими, уникайте небезпечних каналів передавання й ротуйте ключі, якщо підозрюєте витік.

    Контрольний список перевірки

    На новій машині підтвердьте:

    • [ ] openclaw status показує, що Gateway запущено.
    • [ ] Канали все ще підключені (повторне сполучення не потрібне).
    • [ ] Панель керування відкривається й показує наявні сесії.
    • [ ] Файли робочого простору (пам’ять, конфігурації) присутні.

    Оновлення Plugin на місці

    Оновлення Plugin на місці зберігають той самий ідентифікатор Plugin і ключі конфігурації, але можуть перемістити стан на диску в поточну структуру. Посібники з оновлення для окремих Plugin розміщені поруч із їхніми каналами:

    • Міграція Matrix: обмеження відновлення зашифрованого стану, поведінка автоматичних знімків і команди ручного відновлення.

    Пов’язане