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