Миграция OpenClaw на новый компьютер

Это руководство переносит шлюз OpenClaw с одного компьютера на другой без повторного прохождения onboarding.

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

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

Но есть типичные подводные камни с профилями, правами доступа и неполным копированием.

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

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

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

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

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

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

Если не уверены, выполните на старом компьютере:

openclaw status

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

2) Определите workspace

Типичные значения по умолчанию:

~/.openclaw/workspace/ (рекомендуемый workspace)
другая папка, которую вы создали сами

В workspace хранятся файлы MEMORY.md, USER.md, memory/*.md и т.п.

3) Что сохраняется

При копировании и каталога состояния, и workspace вы сохраняете:

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

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

сессии
учётные данные
авторизацию каналов

Они хранятся в $OPENCLAW_STATE_DIR.

Шаги миграции (рекомендуемые)

Шаг 0 — Резервная копия (старый компьютер)

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

openclaw gateway stop

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

# Скорректируйте пути при использовании профиля или нестандартных расположений
cd ~
tar -czf openclaw-state.tgz .openclaw

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

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

Шаг 1 — Установка OpenClaw на новом компьютере

На новом компьютере установите CLI (и Node при необходимости):

См.: Установка

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

Шаг 2 — Копирование каталога состояния + workspace на новый компьютер

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

$OPENCLAW_STATE_DIR (по умолчанию ~/.openclaw/)
workspace (по умолчанию ~/.openclaw/workspace/)

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

scp архивов и распаковка
rsync -a через SSH
внешний диск

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

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

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

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

openclaw doctor

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

Затем:

openclaw gateway restart
openclaw status

Типичные подводные камни (и как их избежать)

Подводный камень: несоответствие profile / state-dir

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

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

Исправление: запускайте шлюз/сервис с тем же profile/state dir, который вы перенесли, затем:

openclaw doctor

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

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

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

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

Подводный камень: права доступа / владелец

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

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

Подводный камень: миграция между remote/local режимами

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

При remote-режиме мигрируйте хост шлюза.

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

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

храните зашифрованными
не передавайте по незащищённым каналам
ротируйте ключи при подозрении на утечку

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

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

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