English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaishiالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiruفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Maintenance

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

OpenClaw поддерживает три пути миграции: импорт из другой агентной системы, перенос существующей установки на новый компьютер и обновление Plugin на месте.

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

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

Migrating from Claude

Импортируйте состояние Claude Code и Claude Desktop, включая CLAUDE.md, MCP-серверы, skills и команды проекта.
Migrating from Hermes

Импортируйте конфигурацию Hermes, поставщиков, MCP-серверы, память, skills и поддерживаемые ключи .env.

Точка входа CLI — openclaw migrate. Онбординг также может предложить миграцию, когда обнаруживает известный источник (openclaw onboard --flow import).

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

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

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

Шаги миграции

  • Stop the gateway and back up

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

    bash
    openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclaw

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

  • Install OpenClaw on the new machine

    Установите CLI (и Node, если нужно) на новом компьютере. Ничего страшного, если онбординг создаст новый ~/.openclaw/. Далее вы его перезапишете.

  • Copy state directory and workspace

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

    bash
    cd ~tar -xzf openclaw-state.tgz

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

  • Run doctor and verify

    На новом компьютере запустите Doctor, чтобы применить миграции конфигурации и восстановить службы:

    bash
    openclaw doctoropenclaw gateway restartopenclaw status

    • Если Telegram или Discord использует резервный вариант env по умолчанию (TELEGRAM_BOT_TOKEN или DISCORD_BOT_TOKEN), проверьте, что перенесенный .env в каталоге состояния содержит эти ключи, не выводя значения секретов:

    bash
    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    openclaw doctor также предупреждает, когда у включенной учетной записи Telegram или Discord по умолчанию нет настроенного токена, а соответствующая переменная env недоступна процессу doctor.

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

    Profile or state-dir mismatch

    Если старый Gateway использовал --profile или OPENCLAW_STATE_DIR, а новый — нет, каналы будут выглядеть как вышедшие из системы, а сеансы будут пустыми. Запустите Gateway с тем же профилем или каталогом состояния, который вы перенесли, затем повторно выполните openclaw doctor.

    Copying only openclaw.json

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

    Permissions and ownership

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

    Remote mode

    Если ваш UI указывает на удаленный Gateway, сеансами и рабочей областью владеет удаленный хост. Переносите сам хост Gateway, а не локальный ноутбук. См. FAQ.

    Secrets in backups

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

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

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

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

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

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

    • Миграция Matrix: ограничения восстановления зашифрованного состояния, поведение автоматического снимка и команды ручного восстановления.

    Связанное

    Was this useful?
    On this page

    On this page