---
read_when:
    - Ви переносите OpenClaw на новий ноутбук або сервер
    - Ви переходите з іншої агентної системи й хочете зберегти стан
    - Ви оновлюєте Plugin на місці
summary: 'Центр міграції: міжсистемні імпорти, перенесення між машинами та оновлення Plugin'
title: Посібник із міграції
x-i18n:
    generated_at: "2026-05-02T03:33:41Z"
    model: gpt-5.5
    provider: openai
    source_hash: e447e38cf0086603a7b30ee5204e63cc8227ebc7a56add26d06ac2798a23e26f
    source_path: install/migrating.md
    workflow: 16
---

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
    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
    cd ~
    tar -xzf openclaw-state.tgz
    ```

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

  </Step>

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

    ```bash
    openclaw doctor
    openclaw gateway restart
    openclaw status
    ```

  </Step>
</Steps>

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

```bash
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.