sidebar_position: 10 title: "Migrate from OpenClaw" description: "Complete guide to migrating your OpenClaw / Clawdbot setup to Hermes Agent — what gets migrated, how config maps, and what to check after." lang: ru

Миграция с OpenClaw

hermes claw migrate импортирует вашу настройку OpenClaw (или устаревшего Clawdbot/Moldbot) в Hermes. В этом руководстве подробно описано, что именно будет перенесено, сопоставления ключей конфигурации и что нужно проверить после миграции.

Быстрый старт

# Preview then migrate (always shows a preview first, then asks to confirm)
hermes claw migrate

# Preview only, no changes
hermes claw migrate --dry-run

# Full migration including API keys, skip confirmation
hermes claw migrate --preset full --migrate-secrets --yes

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

По умолчанию читается из ~/.openclaw/. Устаревшие каталоги ~/.clawdbot/ или ~/.moltbot/ обнаруживаются автоматически. То же самое касается устаревших имен файлов конфигурации (clawdbot.json, moltbot.json).

Опции

Что переносится

Персона, память и инструкции

Файлы рабочей области также проверяются по адресам workspace.default/ и workspace-main/ как резервные пути (в последних версиях OpenClaw переименовывает workspace/ в workspace-main/ и использует workspace-{agentId} для многоагентных настроек).

Навыки (4 источника)

Конфликты навыков обрабатываются --skill-conflict: skip оставляет существующий навык Hermes, overwrite заменяет его, rename создает копию -imported.

Конфигурация модели и поставщика

Поведение агента

Политики сброса сеанса

Примечание. В OpenClaw также имеется session.resetTriggers (простой массив строк, например ["daily", "idle"]). Если структурированный session.reset отсутствует, миграция возвращается к выводу из resetTriggers.

MCP-серверы

TTS (преобразование текста в речь)

Настройки TTS считываются из двух местоположений конфигурации OpenClaw со следующим приоритетом:

1. messages.tts.providers.{provider}.* (каноническое расположение)
2. Верхний уровень talk.providers.{provider}.* (резервный вариант)
3. Устаревшие плоские клавиши messages.tts.{provider}.* (самый старый формат)

Платформы обмена сообщениями

Другая конфигурация

В архиве (нет прямого эквивалента Hermes)

Они сохраняются в ~/.hermes/migration/openclaw/<timestamp>/archive/ для проверки вручную:

Разрешение ключа API

Когда --migrate-secrets включен, ключи API собираются из четырех источников в порядке приоритета:

1. Значения конфигурации — models.providers.*.apiKey и ключи провайдера TTS в openclaw.json
2. Файл среды — ~/.openclaw/.env (ключи типа OPENROUTER_API_KEY, ANTHROPIC_API_KEY и т. д.)
3. Подобъект Config env — openclaw.json → "env" или "env"."vars" (некоторые настройки хранят здесь ключи вместо отдельного файла .env)
4. Профили аутентификации — ~/.openclaw/agents/main/agent/auth-profiles.json (учетные данные для каждого агента)

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

Поддерживаемые ключевые цели

OPENROUTER_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, DEEPSEEK_API_KEY, GEMINI_API_KEY, ZAI_API_KEY, MINIMAX_API_KEY, ELEVENLABS_API_KEY, TELEGRAM_BOT_TOKEN, VOICE_TOOLS_OPENAI_KEY

Ключи, не входящие в этот список разрешений, никогда не копируются.

Обработка секретной ссылки

Значения конфигурации OpenClaw для токенов и ключей API могут быть в трех форматах:

// Plain string
"channels": { "telegram": { "botToken": "123456:ABC-DEF..." } }

// Environment template
"channels": { "telegram": { "botToken": "${TELEGRAM_BOT_TOKEN}" } }

// SecretRef object
"channels": { "telegram": { "botToken": { "source": "env", "id": "TELEGRAM_BOT_TOKEN" } } }

Миграция разрешает все три формата. Для шаблонов env и объектов SecretRef с source: "env" он ищет значение в ~/.openclaw/.env и подобъекте openclaw.json env. Объекты SecretRef с source: "file" или source: "exec" не могут быть разрешены автоматически — миграция предупреждает об этом, и эти значения необходимо добавить в Hermes вручную через hermes config set.

После миграции

1. Проверьте отчет о переносе — он распечатывается по завершении с указанием количества перенесенных, пропущенных и конфликтующих элементов.

2. Просмотр заархивированных файлов — все в ~/.hermes/migration/openclaw/<timestamp>/archive/ требует ручной обработки.

3. Начать новый сеанс — импортированные навыки и записи памяти вступают в силу в новых сеансах, а не в текущем.

4. Проверка ключей API — запустите hermes status, чтобы проверить аутентификацию провайдера.

5. Проверка обмена сообщениями — если вы перенесли токены платформы, перезапустите шлюз: systemctl --user restart hermes-gateway

6. Проверьте политику сеанса — убедитесь, что hermes config get session_reset соответствует вашим ожиданиям.

7. Повторное сопряжение WhatsApp — WhatsApp использует сопряжение QR-кодов (Baileys), а не миграцию токенов. Запустите hermes whatsapp для сопряжения.

8. Очистка архива — убедившись, что все работает, запустите hermes claw cleanup, чтобы переименовать оставшиеся каталоги OpenClaw в .pre-migration/ (предотвращает путаницу состояний).

Устранение неполадок

"Каталог OpenClaw не найден"

При миграции проверяется ~/.openclaw/, затем ~/.clawdbot/, затем ~/.moltbot/. Если ваша установка находится в другом месте, используйте --source /path/to/your/openclaw.

"Ключи API поставщика не найдены"

Ключи могут храниться в нескольких местах в зависимости от вашей версии OpenClaw: встроенные в openclaw.json в models.providers.*.apiKey, в ~/.openclaw/.env, в подобъекте openclaw.json "env" или в agents/main/agent/auth-profiles.json. Миграция проверяет все четыре. Если ключи используют source: "file" или source: "exec" SecretRefs, их нельзя разрешить автоматически — добавьте их через hermes config set.

Навыки не появляются после миграции

Импортированные навыки попадают в ~/.hermes/skills/openclaw-imports/. Начните новый сеанс, чтобы они вступили в силу, или запустите /skills, чтобы убедиться, что они загружены.

Голос TTS не перенесен

OpenClaw хранит настройки TTS в двух местах: messages.tts.providers.* и конфигурация верхнего уровня talk. Миграция проверяет оба. Если ваш голосовой идентификатор был установлен через пользовательский интерфейс OpenClaw (сохранен по другому пути), вам может потребоваться установить его вручную: hermes config set tts.elevenlabs.voice_id YOUR_VOICE_ID.