> ## 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 поддерживает три способа миграции: импорт из другой агентной системы, перенос существующей установки на новый компьютер и обновление плагина на месте.

## Импорт из другой агентной системы

Встроенные провайдеры миграции переносят в OpenClaw инструкции, серверы MCP, навыки, конфигурацию моделей и, при явном согласии, ключи API. Перед внесением изменений отображается предварительный план, секреты в отчётах скрываются, а применение изменений сопровождается созданием проверенной резервной копии.

> [card] [Миграция с Claude](https://docs2.openclaw.ai/ru/install/migrating-claude.md)
>
> Импортируйте состояние Claude Code и Claude Desktop, включая `CLAUDE.md`, серверы MCP, навыки и команды проектов.

> [card] [Миграция с Hermes](https://docs2.openclaw.ai/ru/install/migrating-hermes.md)
>
> Импортируйте конфигурацию Hermes, провайдеров, серверы MCP, память, навыки и поддерживаемые ключи `.env`.

Точка входа CLI — [`openclaw migrate`](https://docs2.openclaw.ai/ru/cli/migrate). Первоначальная настройка также может предложить миграцию при обнаружении известного источника (`openclaw onboard --flow import`).

## Перенос OpenClaw на новый компьютер

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

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

> [!TIP]
>
> Выполните `openclaw status` на старом компьютере, чтобы уточнить путь к каталогу состояния. Пользовательские профили используют `~/.openclaw-<profile>/` или путь, заданный через `OPENCLAW_STATE_DIR`.

### Этапы миграции

**1. Остановите Gateway и создайте резервную копию**

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

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

Если вы используете несколько профилей (например, `~/.openclaw-work`), создайте отдельный архив для каждого из них.

**2. Установите OpenClaw на новый компьютер**

[Установите](https://docs2.openclaw.ai/ru/install.md) CLI (и Node, если требуется) на новый компьютер. Ничего страшного, если первоначальная настройка создаст новый `~/.openclaw/` — на следующем этапе вы его перезапишете.

**3. Скопируйте каталог состояния и рабочее пространство**

Передайте архив через `scp`, `rsync -a` или на внешнем накопителе, затем распакуйте его:

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

Убедитесь, что скрытые каталоги были включены, а владельцем файлов является пользователь, от имени которого будет запускаться Gateway.

**4. Запустите Doctor и выполните проверку**

На новом компьютере запустите [Doctor](https://docs2.openclaw.ai/ru/gateway/doctor.md), чтобы применить миграции конфигурации и восстановить службы:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor
openclaw gateway restart
openclaw status
```

Если Telegram или Discord использует резервное значение из переменной среды по умолчанию (`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 по умолчанию не настроен токен, а соответствующая переменная среды недоступна процессу Doctor.

### Распространённые ошибки

> [accordion] Несоответствие профиля или каталога состояния
>
> Если старый Gateway использовал `--profile` или `OPENCLAW_STATE_DIR`, а новый их не использует, каналы будут отображаться как вышедшие из системы, а сеансы окажутся пустыми. Запустите Gateway с **тем же** профилем или каталогом состояния, который вы перенесли, а затем повторно выполните `openclaw doctor`.

> [accordion] Копирование только openclaw\.json
>
> Одного файла конфигурации недостаточно. Профили аутентификации моделей хранятся в `agents/<agentId>/agent/auth-profiles.json`, а состояние каналов и провайдеров — в `credentials/`. Всегда переносите **весь** каталог состояния.

> [accordion] Разрешения и владелец
>
> Если вы выполняли копирование от имени root или сменили пользователя, Gateway может не получить доступ к учётным данным. Убедитесь, что каталог состояния и рабочее пространство принадлежат пользователю, от имени которого запускается Gateway.

> [accordion] Удалённый режим
>
> Если ваш интерфейс подключён к **удалённому** Gateway, сеансы и рабочее пространство принадлежат удалённому узлу. Перенесите сам узел Gateway, а не локальный ноутбук. См. [часто задаваемые вопросы](https://docs2.openclaw.ai/ru/help/faq.md#where-things-live-on-disk).

> [accordion] Секреты в резервных копиях
>
> Каталог состояния содержит профили аутентификации, учётные данные каналов и другое состояние провайдеров. Храните резервные копии в зашифрованном виде, избегайте небезопасных каналов передачи и замените ключи, если подозреваете их раскрытие.

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

На новом компьютере убедитесь, что:

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

## Обновление плагина на месте

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

* [Миграция Matrix](https://docs2.openclaw.ai/ru/channels/matrix-migration.md): ограничения восстановления зашифрованного состояния, поведение автоматических снимков состояния и команды ручного восстановления.

## Связанные материалы

* [`openclaw migrate`](https://docs2.openclaw.ai/ru/cli/migrate): справочник CLI по импорту из других систем.
* [Обзор установки](https://docs2.openclaw.ai/ru/install.md): все способы установки.
* [Doctor](https://docs2.openclaw.ai/ru/gateway/doctor.md): проверка состояния после миграции.
* [Удаление](https://docs2.openclaw.ai/ru/install/uninstall.md): полное удаление OpenClaw.