Миграция с 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. 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

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

Обработка SecretRef

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

// 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 и в env-подобъекте openclaw.json. Объекты 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, в "env"-подобъекте openclaw.json или в agents/main/agent/auth-profiles.json. Миграция проверяет все четыре. Если ключи используют SecretRef с source: "file" или source: "exec", они не могут быть разрешены автоматически — добавьте их через 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.