Миграция с OpenClaw

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

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

# Предпросмотр, затем миграция (всегда показывает предпросмотр, затем запрашивает подтверждение)
hermes claw migrate

# Только предпросмотр, без изменений
hermes claw migrate --dry-run

# Полная миграция, включая API-ключи, без запроса подтверждения
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

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

// Простая строка
"channels": { "telegram": { "botToken": "123456:ABC-DEF..." } }

// Шаблон окружения
"channels": { "telegram": { "botToken": "${TELEGRAM_BOT_TOKEN}" } }

// Объект SecretRef
"channels": { "telegram": { "botToken": { "source": "env", "id": "TELEGRAM_BOT_TOKEN" } } }

Миграция обрабатывается во всех трех формах. Для окружения шаблонов и объектов 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 /путь/к/вашему/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, чтобы выбрать новую проверку, загруженную ими.

ТТС-голос не перенесен

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