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

# Руководство по миграции

# Миграция OpenClaw на новую машину

Это руководство описывает перенос Gateway (шлюз) OpenClaw с одной машины на другую **без повторного прохождения онбординга**.

Концептуально миграция проста:

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

Однако есть распространённые «подводные камни», связанные с **профилями**, **правами доступа** и **неполными копиями**.

## Перед началом (что именно вы переносите)

### 1. Определите каталог состояния

Большинство установок используют значение по умолчанию:

* **Каталог состояния:** `~/.openclaw/`

Но он может отличаться, если вы используете:

* `--profile <name>` (часто становится `~/.openclaw-<profile>/`)
* `OPENCLAW_STATE_DIR=/some/path`

Если вы не уверены, выполните на **старой** машине:

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

Ищите упоминания `OPENCLAW_STATE_DIR` / профиля в выводе. Если вы запускаете несколько Gateway (шлюзов), повторите для каждого профиля.

### 2. Определите ваше рабочее пространство

Распространённые значения по умолчанию:

* `~/.openclaw/workspace/` (рекомендуемое рабочее пространство)
* пользовательская папка, которую вы создали

Ваше рабочее пространство — это место, где находятся такие файлы, как `MEMORY.md`, `USER.md` и `memory/*.md`.

### 3. Поймите, что будет сохранено

Если вы копируете **и** каталог состояния, **и** рабочее пространство, вы сохраняете:

* Конфигурацию Gateway (шлюз) (`openclaw.json`)
* Профили аутентификации / ключи API / OAuth-токены
* Историю сеансов и состояние агента
* Состояние каналов (например, вход/сеанс WhatsApp)
* Файлы рабочего пространства (память, заметки Skills и т. д.)

Если вы копируете **только** рабочее пространство (например, через Git), вы **не** сохраняете:

* сеансы
* учётные данные
* входы в каналы

Они находятся в `$OPENCLAW_STATE_DIR`.

## Шаги миграции (рекомендуется)

### Шаг 0 — Сделайте резервную копию (старая машина)

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway stop
```

(Необязательно, но рекомендуется) заархивируйте каталог состояния и рабочее пространство:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Adjust paths if you use a profile or custom locations
cd ~
tar -czf openclaw-state.tgz .openclaw

tar -czf openclaw-workspace.tgz .openclaw/workspace
```

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

### Шаг 1 — Установите OpenClaw на новой машине

На **новой** машине установите CLI (и Node, если требуется):

* См.: [Install](/install)

На этом этапе нормально, если онбординг создаст новый `~/.openclaw/` — вы перезапишете его на следующем шаге.

### Шаг 2 — Скопируйте каталог состояния и рабочее пространство на новую машину

Скопируйте **оба**:

* `$OPENCLAW_STATE_DIR` (по умолчанию `~/.openclaw/`)
* ваше рабочее пространство (по умолчанию `~/.openclaw/workspace/`)

Распространённые способы:

* `scp` архивы и извлечь
* `rsync -a` по SSH
* внешний накопитель

После копирования убедитесь, что:

* Скрытые каталоги были включены (например, `.openclaw/`)
* Владение файлами корректно для пользователя, под которым запускается шлюз

### Шаг 3 — Запустите Doctor (миграции + восстановление сервисов)

На **новой** машине:

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

Doctor — это «безопасная и надёжная» команда. Она восстанавливает сервисы, применяет миграции конфигурации и предупреждает о несоответствиях.

Затем:

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

## Обычные пулеметы (и как их избежать)

### Подводный камень: несоответствие профиля / каталога состояния

Если вы запускали старый шлюз с профилем (или `OPENCLAW_STATE_DIR`), а новый шлюз использует другой, вы увидите такие симптомы, как:

* изменения конфигурации не применяются
* каналы отсутствуют / вышли из системы
* пустая история сеансов

Исправление: запустите шлюз/сервис, используя **тот же** профиль/каталог состояния, который вы перенесли, затем повторно выполните:

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

### Подводный камень: копирование только `openclaw.json`

`openclaw.json` недостаточно. Многие провайдеры хранят состояние в:

* `$OPENCLAW_STATE_DIR/credentials/`
* `$OPENCLAW_STATE_DIR/agents/<agentId>/...`

Всегда переносите весь каталог `$OPENCLAW_STATE_DIR` целиком.

### Футбол: разрешения / право собственности

Если вы копировали файлы от root или сменили пользователя, шлюз может не иметь доступа к учётным данным или сеансам.

Исправление: убедитесь, что каталог состояния и рабочее пространство принадлежат пользователю, под которым запускается шлюз.

### Подводный камень: миграция между удалённым и локальным режимами

* Если ваш UI (WebUI/TUI) указывает на **удалённый** шлюз, удалённый хост владеет хранилищем сеансов и рабочим пространством.
* Перенос вашего ноутбука не перенесёт состояние удалённого шлюза.

Если вы используете удалённый режим, переносите **хост шлюза Gateway**.

### Подводный камень: секреты в резервных копиях

`$OPENCLAW_STATE_DIR` содержит секреты (ключи API, OAuth-токены, учётные данные WhatsApp). Обращайтесь с резервными копиями как с production-секретами:

* храните в зашифрованном виде
* избегайте передачи по небезопасным каналам
* вращать ключи, если вы подозреваете воздействие

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

На новой машине убедитесь, что:

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

## Связанное

* [Doctor](/gateway/doctor)
* [Gateway troubleshooting](/gateway/troubleshooting)
* [Where does OpenClaw store its data?](/help/faq#where-does-openclaw-store-its-data)