> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

<CardGroup cols={2}>
  <Card title="Міграція з Claude" href="/uk/install/migrating-claude" icon="brain">
    Імпортуйте стан Claude Code і Claude Desktop, зокрема `CLAUDE.md`, сервери MCP, Skills і команди проєкту.
  </Card>

  <Card title="Міграція з Hermes" href="/uk/install/migrating-hermes" icon="feather">
    Імпортуйте конфігурацію Hermes, постачальників, сервери MCP, пам’ять, Skills і підтримувані ключі `.env`.
  </Card>
</CardGroup>

Точка входу CLI — [`openclaw migrate`](/uk/cli/migrate). Під час онбордингу також може бути запропонована міграція, якщо виявлено відоме джерело (`openclaw onboard --flow import`).

## Перенесення OpenClaw на нову машину

Скопіюйте **каталог стану** (`~/.openclaw/` за замовчуванням) і ваш **робочий простір**, щоб зберегти:

* **Конфігурацію** — `openclaw.json` і всі налаштування Gateway.
* **Автентифікацію** — `auth-profiles.json` для кожного агента (ключі API плюс OAuth), а також будь-який стан каналу або постачальника в `credentials/`.
* **Сесії** — історію розмов і стан агента.
* **Стан каналу** — вхід WhatsApp, сесію Telegram тощо.
* **Файли робочого простору** — `MEMORY.md`, `USER.md`, Skills і промпти.

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

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

<Steps>
  <Step title="Зупиніть Gateway і створіть резервну копію">
    На **старій** машині зупиніть Gateway, щоб файли не змінювалися під час копіювання, а потім створіть архів:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway stop
    cd ~
    tar -czf openclaw-state.tgz .openclaw
    ```

    Якщо ви використовуєте кілька профілів (наприклад, `~/.openclaw-work`), заархівуйте кожен окремо.
  </Step>

  <Step title="Встановіть OpenClaw на новій машині">
    [Встановіть](/uk/install) CLI (і Node, якщо потрібно) на новій машині. Нічого страшного, якщо онбординг створить свіжий `~/.openclaw/`. Далі ви його перезапишете.
  </Step>

  <Step title="Скопіюйте каталог стану та робочий простір">
    Передайте архів через `scp`, `rsync -a` або зовнішній диск, а потім розпакуйте:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    cd ~
    tar -xzf openclaw-state.tgz
    ```

    Переконайтеся, що приховані каталоги були включені, а власник файлів відповідає користувачу, який запускатиме Gateway.
  </Step>

  <Step title="Запустіть doctor і перевірте">
    На новій машині запустіть [Doctor](/uk/gateway/doctor), щоб застосувати міграції конфігурації та відновити служби:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw doctor
    openclaw gateway restart
    openclaw status
    ```
  </Step>
</Steps>

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env
```

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

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

<AccordionGroup>
  <Accordion title="Невідповідність профілю або каталогу стану">
    Якщо старий Gateway використовував `--profile` або `OPENCLAW_STATE_DIR`, а новий — ні, канали виглядатимуть розлогіненими, а сесії будуть порожніми. Запустіть Gateway із **тим самим** профілем або каталогом стану, який ви перенесли, а потім повторно запустіть `openclaw doctor`.
  </Accordion>

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

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

  <Accordion title="Віддалений режим">
    Якщо ваш UI вказує на **віддалений** Gateway, сесіями та робочим простором володіє віддалений хост. Мігруйте сам хост Gateway, а не свій локальний ноутбук. Див. [FAQ](/uk/help/faq#where-things-live-on-disk).
  </Accordion>

  <Accordion title="Секрети в резервних копіях">
    Каталог стану містить профілі автентифікації, облікові дані каналів та інший стан постачальників. Зберігайте резервні копії зашифрованими, уникайте небезпечних каналів передавання й ротуйте ключі, якщо підозрюєте витік.
  </Accordion>
</AccordionGroup>

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

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

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

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

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

* [Міграція Matrix](/uk/channels/matrix-migration): обмеження відновлення зашифрованого стану, поведінка автоматичних знімків і команди ручного відновлення.

## Пов’язане

* [`openclaw migrate`](/uk/cli/migrate): довідка CLI для імпорту між системами.
* [Огляд встановлення](/uk/install): усі способи встановлення.
* [Doctor](/uk/gateway/doctor): перевірка стану після міграції.
* [Видалення](/uk/install/uninstall): чисте видалення OpenClaw.