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

​
Міграція OpenClaw на нову машину

Цей посібник допоможе перенести gateway OpenClaw на нову машину без повторного проходження onboarding.

​
Що переноситься

Коли ви копіюєте state dir (типово ~/.openclaw/) і свій workspace, ви зберігаєте:
  • Config — openclaw.json і всі налаштування gateway
  • Auth — auth-profiles.json для кожного агента (API key + OAuth), а також будь-який стан каналу/провайдера в credentials/
  • Sessions — історію розмов і стан агента
  • Стан каналу — вхід у WhatsApp, сесію Telegram тощо
  • Файли workspace — MEMORY.md, USER.md, Skills і prompts
Виконайте openclaw status на старій машині, щоб підтвердити шлях до вашої state dir. Кастомні профілі використовують ~/.openclaw-<profile>/ або шлях, заданий через OPENCLAW_STATE_DIR.

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

1

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

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

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

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

Скопіюйте state dir і workspace

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

Запустіть doctor і перевірте

На новій машині запустіть Doctor, щоб застосувати міграції config і відновити services:
openclaw doctor
openclaw gateway restart
openclaw status

​
Поширені проблеми

Якщо старий gateway використовував --profile або OPENCLAW_STATE_DIR, а новий — ні, канали виглядатимуть як вийшли з облікового запису, а сесії будуть порожні. Запустіть gateway з тим самим профілем або state-dir, який ви перенесли, а потім знову виконайте openclaw doctor.
Одного лише файлу config недостатньо. Профілі auth моделей зберігаються в agents/<agentId>/agent/auth-profiles.json, а стан каналу/провайдера як і раніше зберігається в credentials/. Завжди переносіть усю state dir.
Якщо ви копіювали як root або змінили користувача, gateway може не змогти прочитати облікові дані. Переконайтеся, що state dir і workspace належать користувачу, від імені якого працює gateway.
Якщо ваш UI вказує на віддалений gateway, саме віддалений хост володіє сесіями та workspace. Переносьте сам хост gateway, а не локальний ноутбук. Див. FAQ.
State dir містить профілі auth, облікові дані каналів та інший стан провайдерів. Зберігайте резервні копії в зашифрованому вигляді, уникайте небезпечних каналів передачі й ротуйте ключі, якщо підозрюєте витік.

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

На новій машині переконайтеся, що:
  • openclaw status показує, що gateway запущено
  • Канали все ще підключені (повторне pairing не потрібне)
  • Dashboard відкривається і показує наявні сесії
  • Файли workspace (memory, configs) присутні