> ## 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="Migrating from Claude" href="/ru/install/migrating-claude" icon="brain">
    Импортируйте состояние Claude Code и Claude Desktop, включая `CLAUDE.md`, MCP-серверы, skills и команды проекта.
  </Card>

  <Card title="Migrating from Hermes" href="/ru/install/migrating-hermes" icon="feather">
    Импортируйте конфигурацию Hermes, поставщиков, MCP-серверы, память, skills и поддерживаемые ключи `.env`.
  </Card>
</CardGroup>

Точка входа CLI — [`openclaw migrate`](/ru/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="Stop the gateway and back up">
    На **старом** компьютере остановите 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="Install OpenClaw on the new machine">
    [Установите](/ru/install) CLI (и Node, если нужно) на новом компьютере. Ничего страшного, если онбординг создаст новый `~/.openclaw/`. Далее вы его перезапишете.
  </Step>

  <Step title="Copy state directory and workspace">
    Перенесите архив через `scp`, `rsync -a` или внешний диск, затем распакуйте:

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

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

  <Step title="Run doctor and verify">
    На новом компьютере запустите [Doctor](/ru/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="Profile or state-dir mismatch">
    Если старый Gateway использовал `--profile` или `OPENCLAW_STATE_DIR`, а новый — нет, каналы будут выглядеть как вышедшие из системы, а сеансы будут пустыми. Запустите Gateway с **тем же** профилем или каталогом состояния, который вы перенесли, затем повторно выполните `openclaw doctor`.
  </Accordion>

  <Accordion title="Copying only openclaw.json">
    Одного файла конфигурации недостаточно. Профили аутентификации моделей находятся в `agents/<agentId>/agent/auth-profiles.json`, а состояние каналов и поставщиков находится в `credentials/`. Всегда переносите **весь** каталог состояния.
  </Accordion>

  <Accordion title="Permissions and ownership">
    Если вы копировали от имени root или сменили пользователя, Gateway может не суметь прочитать учетные данные. Убедитесь, что каталог состояния и рабочая область принадлежат пользователю, который запускает Gateway.
  </Accordion>

  <Accordion title="Remote mode">
    Если ваш UI указывает на **удаленный** Gateway, сеансами и рабочей областью владеет удаленный хост. Переносите сам хост Gateway, а не локальный ноутбук. См. [FAQ](/ru/help/faq#where-things-live-on-disk).
  </Accordion>

  <Accordion title="Secrets in backups">
    Каталог состояния содержит профили аутентификации, учетные данные каналов и другое состояние поставщиков. Храните резервные копии в зашифрованном виде, избегайте небезопасных каналов передачи и ротируйте ключи, если подозреваете раскрытие.
  </Accordion>
</AccordionGroup>

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

На новом компьютере подтвердите:

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

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

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

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

## Связанное

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