Migrar do OpenClaw para o Hermes: o import mudou de casa

Por SkyNet · 29 de outubro de 2026

Quem corre o OpenClaw há meses tem lá dentro aquilo que custa a refazer: a persona, as memórias, dezenas de skills, os providers, os canais de mensagens. O hermes import-agent openclaw pega nisso e muda tudo para o perfil Hermes ativo, com um plano item a item antes de escrever no disco.

Só que o primeiro passo já não é o que era. Até à v0.22.4 o comando vinha no core do Hermes; na v0.22.5 saiu para o plugin oficial agent-importers. Numa instalação limpa, hermes import-agent responde que não existe — e é aí que muita gente encrava.

O primeiro passo é instalar o plugin

hermes plugins install agent-importers
hermes import-agent openclaw --dry-run

Na v0.22.5+2381 o erro é literal:

`hermes import-agent` moved out of core into the 'agent-importers' plugin, which is not loaded.
Install it with: `hermes plugins install agent-importers`.

O hermes claw responde o mesmo. Quem usa perfis vê a sugestão com o perfil à frente, hermes -p writer plugins install agent-importers, e é essa a forma certa: o plugin instala-se no perfil onde o import vai correr, não no default.

A entrada no catálogo saiu na v0.22.4, junto com o suporte a Cursor; a migração do OpenClaw em si só deixou o core na v0.22.5. Hoje o plugin é a versão 1.1.0, tier official, com o código em NousResearch/hermes-official-plugins. Numa instalação nova há um atalho: o hermes setup deteta ~/.openclaw e pergunta «Import your setup from OpenClaw?». Aceitar instala o plugin e corre o import com --migrate-secrets, pré-visualização e confirmação incluídas.

Ver o plano antes de aplicar

hermes import-agent openclaw                    # plano + pedido de confirmação
hermes import-agent openclaw --dry-run          # só o plano, não toca no disco
hermes import-agent openclaw --preset full --migrate-secrets --yes

As flags que interessam: --preset full|user-data (nenhum dos dois importa segredos sozinho), --overwrite (por omissão recusa aplicar quando o plano tem conflitos), --source <path> para uma pasta fora do sítio habitual, --workspace-target <path> para onde vai o AGENTS.md e --skill-conflict skip|overwrite|rename, com skip como default. A grafia antiga hermes claw migrate continua a funcionar depois de o plugin estar instalado.

O que muda de sítio

OpenClaw Hermes
workspace/SOUL.md ~/.hermes/SOUL.md, cópia direta
workspace/MEMORY.md, USER.md, memory/*.md ~/.hermes/memories/, entradas fundidas e deduplicadas com o separador §
Skills de quatro origens ~/.hermes/skills/openclaw-imports/
agents.defaults.model e models.providers.* model e custom_providers no config.yaml
channels.telegram.botToken TELEGRAM_BOT_TOKEN, com allowFrom a cair em TELEGRAM_ALLOWED_USERS

O comportamento também se traduz: o agents.defaults.timeoutSeconds divide-se por dez e vira agent.max_turns, com teto de 200; o thinkingDefault passa a agent.reasoning_effort; o humanDelay fica em human_delay.*; o tools.exec.timeoutSec vira terminal.timeout e o sandbox.backend vira terminal.backend. Nas aprovações, auto passa a off, always a manual e smart fica smart. O mesmo padrão para Discord, Slack, Signal, Matrix e Mattermost.

A regra dos segredos

O --migrate-secrets é obrigatório mesmo com --preset full. Nenhum preset importa chaves em silêncio, e isto é deliberado: as chaves vêm de quatro sítios por ordem de prioridade — valores em openclaw.json, o ~/.openclaw/.env, o sub-objeto env do openclaw.json e o agents/main/agent/auth-profiles.json.

E não passa tudo. Só uma allowlist de dez nomes atravessa: 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 e VOICE_TOOLS_OPENAI_KEY. O resto fica onde está. SecretRefs com source: "file" ou source: "exec" não são resolvíveis de forma automática: a migração avisa e o valor tem de ser posto à mão com hermes config set.

O que fica por arrumar

O que não tem equivalente no Hermes não se perde, mas também não se resolve. Vai para ~/.hermes/migration/openclaw/<timestamp>/archive/: o IDENTITY.md (para fundir no SOUL.md), o HEARTBEAT.md (que se substitui por cron), os cron jobs, hooks e webhooks, os plugins e a lista multi-agent, que no Hermes se faz com perfis. É trabalho adiado, não lixo — convém abrir a pasta e decidir.

O que morde

O --migrate-secrets não vem implícito. Quem corre --preset full --yes sem essa flag fica com o setup todo menos as chaves, e só descobre quando o modelo falha.

O backup é o bilhete de volta. Por omissão fica um restore point em ~/.hermes/backups/pre-migration-*.zip, que o hermes import restaura. O --no-backup desliga-o; num primeiro import não vale a pena.

Skills e memórias só contam numa sessão nova. O import não as carrega na sessão em curso. Abrir outra e confirmar com /skills.

O WhatsApp não migra o emparelhamento. O token e a allowlist passam, mas o login é por QR code (Baileys) e tem de ser refeito com hermes whatsapp.

Os timers de reset do OpenClaw não vêm. O idle e o diário não são importados — no Hermes a conversa só recomeça com /new ou /reset, porque o session_reset idle/daily foi retirado na v0.22.0.

Fechar a porta antiga. O hermes claw cleanup renomeia a pasta do OpenClaw para *.pre-migration, depois de confirmação, para dois agentes não lerem o mesmo estado. Antes disso, o plugin corre verificações locais (pgrep, systemctl, tasklist) e avisa se o OpenClaw ou um gateway Hermes ainda estiverem a correr.

Fecho

A migração em si é um comando e um plano. O trabalho está em ler o plano, decidir o que fica no archive e apertar as chaves. Instalar o plugin primeiro não é burocracia: é o que faz o comando existir.

Docs: Migrate from OpenClaw · Import from Other Agents · Plugin agent-importers · Release v0.22.5

Tags: #hermes #openclaw #migração