Как перенести OpenClaw с компьютера на VPS и сохранить рабочую историю

MAATRIX · 17 октября 2026 · 8 мин чтения

Самая неприятная миграция выглядит почти удачной. Новый сервер отвечает, панель открывается, модель здоровается — и совершенно не помнит, что вы делали последние две недели. Оказывается, переехала программа, а её рабочая жизнь осталась на ноутбуке.

У OpenClaw нужно переносить состояние и рабочие материалы. В них находятся настройки, история, сведения об авторизации, инструкции и результаты заданий. При этом старый и новый экземпляры не должны одновременно исполнять одни и те же расписания. Разберём переезд как небольшую операцию с понятной точкой переключения: сначала подготовка, потом остановка, перенос и проверка. Ноутбук останется запасным вариантом до завершения приёмки.

Составляем опись перед упаковкой

Начните на старом компьютере с проверки состояния:

openclaw status

Запишите установленную версию, активный профиль, путь к состоянию и расположение рабочей папки. По умолчанию состояние находится в ~/.openclaw/, но профиль или переменная OPENCLAW_STATE_DIR могут изменить адрес. Копирование первой найденной папки с похожим именем — популярный способ перевозить чужой чемодан, уверенно считая его своим.

Отдельно перечислите подключённые каналы, модели, внешние инструменты и задания по расписанию. Для каждого укажите ожидаемый результат после переезда: бот отвечает, провайдер модели принимает запрос, документ доступен, утреннее задание запускается ровно один раз. Сохраните три контрольных примера из истории: недавнюю беседу, созданный файл и действующее автоматическое задание.

Проверьте, нет ли внешних зависимостей. Рабочая папка может содержать ссылку на каталог за её пределами. Инструмент может обращаться к программе, установленной только на вашем Mac, а локальный MCP-сервер — запускаться по абсолютному пути, которого в Linux не существует. Такие подключения не переезжают одной упаковкой состояния. Их придётся установить заново или заменить удалённым способом доступа.

Что переносится, а что нужно подключать отдельно

В руководстве по миграции OpenClaw разделены состояние приложения и workspace. Для владельца это удобнее представить в виде списка имущества.

Парольный менеджер, системное хранилище секретов и OAuth-сессия могут зависеть от исходной машины. Поэтому «архив создан успешно» не означает «все интеграции уже готовы». Для каждого подключения предусмотрите проверку и возможность повторной авторизации. Не пытайтесь исправить отсутствующий секрет копированием его в обычный текстовый файл внутри workspace.

Ещё один тонкий момент — браузер. Серверный браузер и браузер на вашем ноутбуке имеют разные профили, файлы cookie и возможности взаимодействия с операционной системой. Сначала переносите задачи, которым достаточно серверных файлов и API. Работа с локальным устройством требует отдельной настройки узла и проверки разрешений.

Готовим новое место

На VPS установите поддерживаемую Linux-систему и создайте отдельного пользователя для OpenClaw. Подготовьте SSH-доступ, затем установите приложение по актуальной инструкции проекта. Для первой проверки желательно сохранить ту же версию OpenClaw, что использовалась на старой машине. Обновление и переезд лучше разделить: так у каждой ошибки будет меньше возможных причин.

Не включайте на новом экземпляре привычные расписания и каналы отправки до восстановления. Свежая установка может создать пустое состояние — это нормально, но его следует отличать от перенесённого. Запишите, какая папка появилась автоматически, и убедитесь, что Gateway остановлен перед заменой данных.

Для помощника с внешним API модели отправной конфигурацией MAATRIX может стать Uab Start с 2 vCPU и 4 GB памяти. Если на компьютере уже используются браузер, обработка PDF или несколько параллельных задач, начните испытание с Heka Standard, 4 vCPU и 8 GB. Потребность в диске оценивайте по фактическому объёму состояния, документов и временных файлов, добавив место для архива и распаковки. Переезд на диск, который вмещает только итоговую папку, часто заканчивается посередине распаковки.

Останавливаем запись и создаём архив

Выберите момент, когда агент не выполняет важную задачу. Остановите Gateway на исходной машине, а затем создайте проверяемый архив:

openclaw gateway stop
mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify

Перед выполнением сверяйте наличие этих команд с версией своего CLI. Остановка нужна не для торжественности. Пока приложение записывает состояние, копия базы и связанных файлов может получиться несогласованной. Обычное перетаскивание работающего каталога не даёт такой же уверенности, как остановка и штатный механизм резервирования.

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

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

Сначала восстановление в отдельную папку

Не распаковывайте архив поверх работающей установки. Штатное восстановление позволяет сначала получить данные в отдельном месте:

openclaw backup restore ARCHIVE.tar.gz --target ~/openclaw-restored

Замените ARCHIVE.tar.gz реальным именем переданного файла. Восстановление само по себе не должно рассматриваться как автоматическое включение прежнего экземпляра. Проверьте полученный манифест, расположение состояния и workspace, затем сопоставьте их с путями на VPS.

Особенно внимательно просмотрите абсолютные символические ссылки. Ссылка на папку старого пользователя может остаться синтаксически правильной, но вести в никуда. Исправьте путь или отдельно восстановите нужные данные. У файлов должен быть владелец, под которым будет запущен Gateway; массовое расширение прав для всех пользователей здесь только скроет проблему.

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

Приёмка без внешних последствий

Запустите диагностику и прочитайте её вывод до включения автоматизаций:

openclaw doctor
openclaw gateway restart
openclaw status

Диагностика может предлагать изменения конфигурации или сервисов. Делайте это при сохранённом исходном архиве. Затем откройте панель через защищённый доступ, например SSH-туннель, и найдите контрольную беседу. Проверьте файл из описи и выполните короткий запрос к модели без отправки сообщений сторонним адресатам.

Каналы проверяйте последовательно. Сначала один личный тестовый диалог, затем инструмент чтения, потом инструмент записи в тестовый объект. Если канал требует повторной авторизации, выполните её штатно. Восстановление старого состояния некоторых интеграций может рассинхронизировать сессии, поэтому сообщение об успешном старте процесса ещё ничего не говорит о здоровье каждого канала.

Сверьте часовой пояс расписаний. Задание «каждый день в девять» без уточнённого часового пояса может начать уважать совершенно другое утро. После включения одного расписания дождитесь результата и проверьте, что старый компьютер ничего параллельно не отправил.

Если приложение отвечает, а инструмент перестал работать

Сравните окружение старого и нового процесса. Интерактивный терминал может видеть программу, установленную в домашнюю папку, тогда как фоновая служба запускается с другим набором путей. Проверьте фактического пользователя службы, рабочий каталог и переменные, необходимые именно этому инструменту. Не копируйте всё окружение ноутбука без разбора: там бывают ненужные серверу секреты.

Для внешнего подключения проверьте имя узла, разрешение адреса, сертификат и правила доступа у поставщика. Некоторые интеграции ограничивают разрешённые адреса клиента; после переезда адрес изменяется. Диагностируйте один слой за другим, начиная с короткого безопасного запроса. Если библиотека зависит от системного пакета, установите поддерживаемую Linux-версию и повторите только её тест. Исправленный инструмент затем включите в общую проверку, чтобы изменение не осталось незамеченным в памятке.

Переключение и путь назад

Когда контрольные примеры пройдены, объявите VPS основным экземпляром для себя и остальных пользователей. Старый Gateway оставьте остановленным. Не ведите работу попеременно на двух машинах: истории и результаты начнут расходиться, а последующее объединение станет отдельным проектом.

Если обнаружилась критическая проблема, сначала остановите новый экземпляр. Зафиксируйте, какие задания успели выполнить внешние действия. Простое включение старой копии не отменяет уже отправленное письмо или созданную запись. После этой проверки возвращайте обслуживание на старую машину и восстанавливайте согласованное состояние канала, если это необходимо.

Через несколько дней нормальной работы сделайте новую резервную копию уже на VPS. Проверьте автозапуск после перезагрузки и сохраните краткую памятку о путях, версии и способе восстановления. Затем удалите временные незашифрованные архивы из мест, где они больше не нужны, сохранив защищённую резервную копию по выбранному сроку хранения.

Подходящий VPS MAATRIX решает вопрос постоянного рабочего места помощника. Сохранность его рабочей памяти обеспечивается чуть более прозаично: описью, остановкой записи, проверенным архивом и спокойной приёмкой. Именно эти четыре вещи делают переезд предсказуемым.