Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 і промпти.
Запустіть openclaw status на старій машині, щоб підтвердити шлях до каталогу стану. Користувацькі профілі використовують ~/.openclaw-<profile>/ або шлях, заданий через OPENCLAW_STATE_DIR.

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

1

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

На старій машині зупиніть Gateway, щоб файли не змінювалися під час копіювання, а потім створіть архів:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
Якщо ви використовуєте кілька профілів (наприклад, ~/.openclaw-work), заархівуйте кожен окремо.
2

Встановіть OpenClaw на новій машині

Встановіть CLI (і Node, якщо потрібно) на новій машині. Нічого страшного, якщо онбординг створить свіжий ~/.openclaw/. Далі ви його перезапишете.
3

Скопіюйте каталог стану та робочий простір

Передайте архів через scp, rsync -a або зовнішній диск, а потім розпакуйте:
cd ~
tar -xzf openclaw-state.tgz
Переконайтеся, що приховані каталоги були включені, а власник файлів відповідає користувачу, який запускатиме Gateway.
4

Запустіть 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.
Самого файлу конфігурації недостатньо. Профілі автентифікації моделей зберігаються в agents/<agentId>/agent/auth-profiles.json, а стан каналів і постачальників — у credentials/. Завжди мігруйте весь каталог стану.
Якщо ви копіювали від root або змінили користувача, Gateway може не змогти прочитати облікові дані. Переконайтеся, що каталог стану й робочий простір належать користувачу, який запускає Gateway.
Якщо ваш UI вказує на віддалений Gateway, сесіями та робочим простором володіє віддалений хост. Мігруйте сам хост Gateway, а не свій локальний ноутбук. Див. FAQ.
Каталог стану містить профілі автентифікації, облікові дані каналів та інший стан постачальників. Зберігайте резервні копії зашифрованими, уникайте небезпечних каналів передавання й ротуйте ключі, якщо підозрюєте витік.

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

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

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

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

​
Пов’язане