Migrar o OpenClaw para o Hermes: o que é transferido e o que é arquivado

Migrar o OpenClaw para o Hermes é um comando oficial: hermes claw migrate. Ele lê ~/.openclaw/, mostra uma prévia completa antes de gravar qualquer coisa e, por padrão, grava primeiro um zip de restauração — mas não importa seus trabalhos cron, e é nessa omissão que uma configuração migrada começa silenciosamente a pagar em dobro. A ordem segura é fazer backup, executar uma simulação, aplicar, verificar em uma sessão nova, interromper o agendador antigo e só então fazer a limpeza.

Fixe as entidades antes de qualquer coisa, porque esta consulta se confunde com três produtos não relacionados. Esta página trata do Hermes Agent da Nous Research — a CLI e o gateway, versão mais recente v0.21.3 (tag v2026.9.14, publicada em 14 de setembro de 2026) — e do OpenClaw da OpenClaw Foundation, versão mais recente v2026.9.5, publicada em 19 de setembro de 2026. Ambos os repositórios estavam ativos e não arquivados quando seus metadados foram verificados novamente em 21 de setembro de 2026. Não se trata do Hermes 4, a família separada de modelos de pesos abertos da Nous Research; nem do mecanismo JavaScript Hermes da Meta; nem da casa de luxo. Se você ainda está em ~/.clawdbot/ ou ~/.moltbot/, esse é o mesmo produto com nomes anteriores, e o importador detecta ambos os diretórios e os nomes de configuração clawdbot.json / moltbot.json.

Por que as pessoas migram e quem não deveria

Preço não é o motivo. Ambos os projetos são software livre: o README do OpenClaw afirma que ele "não tem plano pago, serviço hospedado ou token", e seu arquivo LICENSE é MIT puro, embora a API do GitHub informe NOASSERTION no campo de licença do repositório — cite o arquivo, não o campo. O Hermes Agent é informado como MIT pela API do GitHub. O que você paga em qualquer um dos casos são os tokens dos modelos e o host no qual executa o gateway.

Vale fazer uma correção, pois as páginas de comparação mais antigas estão desatualizadas: a direção inversa não é mais somente de memória. O OpenClaw agora documenta uma migração completa com prévia — openclaw migrate hermes --dry-run, depois openclaw migrate apply hermes --yes — importando a configuração de modelos, provedores e endpoints personalizados, servidores MCP, SOUL.md e AGENTS.md, arquivos de memória (anexados), configuração de memória, habilidades com suas configurações e credenciais de autenticação mediante consentimento. O que essa documentação ainda descreve como cópia somente de memória são as importações de memória da integração inicial e da interface de controle, que colocam MEMORY.md e USER.md em memory/imports/hermes/ sem tocar na memória existente do workspace. Portanto, esta é uma via de mão dupla, com um alerta no retorno: não deixe Hermes e OpenClaw compartilharem a mesma concessão de atualização.

O que é migrado e o que é arquivado em vez disso

Leia esta tabela como a lista de aceitação. Tudo na coluna da direita é trabalho que você faz manualmente, no cronograma que escolher, e não uma falha da ferramenta — o Hermes o arquiva deliberadamente em ~/.hermes/migration/openclaw/<timestamp>/archive/.

Duas conversões são sujeitas a perdas de uma forma que uma lista de verificação oculta. agents.defaults.timeoutSeconds não se torna um tempo limite do Hermes — torna-se agent.max_turns, calculado como timeoutSeconds / 10 e limitado a 200. E o vocabulário de dez valores de esforço de raciocínio do OpenClaw é reduzido a três: always, high e xhigh resultam em high; auto, medium e adaptive em medium; off, low, none e minimal em low. Ambos são cálculos, não cópias; portanto, verifique os valores resultantes em vez de presumir que sua configuração antiga foi preservada. Os temporizadores de inatividade da sessão e de redefinição diária não são importados: as conversas do Hermes persistem até um /new ou /reset explícito. Tudo isso vem do guia oficial de migração do OpenClaw, consultado em 19 de setembro de 2026.

O comando, opção por opção

Uma ordem de trabalho que segue a lista de verificação oficial pós-migração sem inventar etapas. Primeiro, interrompa o agendamento do OpenClaw: openclaw cron list; depois, openclaw cron disable <job-id> para qualquer coisa que pudesse ser duplicada (openclaw automations é um alias documentado para qualquer um dos dois). Segundo, execute a simulação. Terceiro, aplique, permitindo que o zip de restauração padrão seja gravado. Quarto, leia o relatório de migração e tudo dentro do diretório de arquivo. Quinto — esta etapa pega muita gente de surpresa — inicie uma nova sessão; as habilidades e entradas de memória importadas não têm efeito na sessão em que você já estava, e /skills confirma o que foi carregado. Sexto, hermes status para autenticação do provedor, reinicie o gateway se você tiver movido tokens da plataforma e faça o pareamento do WhatsApp novamente se o utilizava. Somente depois de tudo isso passar, execute hermes claw cleanup, que renomeia os diretórios restantes do OpenClaw para .pre-migration/, para que dois agentes não possam ler o mesmo estado. É um subcomando separado, não uma opção de migrate; o guia não documenta opções próprias para ele.

A ressalva sobre a ordem é honesta, embora desconfortável: a documentação do Hermes coloca a limpeza na etapa 8 e não diz o que acontece se um serviço de gateway do OpenClaw ainda estiver instalado quando seu diretório for renomeado. Interromper primeiro o agendador e o gateway do OpenClaw é defensável com base na documentação de ambos os projetos; não é uma sequência que qualquer um dos projetos explicite.

A conta da programação duplicada, calculada

Os jobs do Cron são arquivados, não importados. Portanto, a falha natural é: você recria quatro jobs no Hermes, o gateway do OpenClaw continua instalado e agora cada prompt agendado é executado duas vezes contra seu provedor. Veja quanto isso custa como aritmética de tokens, não como custo medido de um job nem como teto da cobrança. Suponha que uma execução agendada envie 25,000 tokens de entrada não armazenados em cache e retorne 1,500 tokens de saída, e que quatro jobs executados a cada duas horas produzam 48 execuções duplicadas por dia. As tarifas são os preços atuais do catálogo da Kunavo por milhão de tokens.

Substitua o formato e a cadência das suas próprias execuções; o ponto é o multiplicador, não a linha. Se o trabalho duplicado já estiver sendo executado, o Hermes documenta uma única alavanca: hermes pause é uma parada de emergência global — nenhuma nova execução do cron, nenhum despacho do kanban e nenhuma execução do gateway começa até hermes resume, e o trabalho em andamento não é encerrado. Use-a para conter o problema e depois desative o lado correto. Observe o limite de permissões no lado do OpenClaw: a referência de automações informa que add/create, edit, remove e run exigem operator.admin. Ela não informa se disable está incluído nesse conjunto, portanto reserve margem para precisar dessa função.

Vale mencionar duas fontes de custo mais discretas após a migração. A página de configuração de modelos do Hermes alerta que os caches de prompts são associados ao modelo que atende à solicitação; portanto, uma troca de /model no meio da conversa faz a próxima mensagem reler toda a conversa pelo preço integral dos tokens de entrada. A página de provedores de fallback diz o mesmo sobre um fallback automático, e a página de pools de credenciais informa que os caches do lado do provedor são vinculados à conta ou chave que fez a solicitação; assim, uma rotação de pool também custa uma passagem pelo preço integral. Em Claude Sonnet 4.6 às tarifas do catálogo, reler uma conversa de 200,000 tokens custa cerca de $0.420 à $2.10 tarifa de entrada, contra aproximadamente $0.042 à $0.21 tarifa de leitura do cache — novamente, aritmética ilustrativa baseada nas premissas indicadas. O Hermes oferece model.switch_context_confirm_tokens como proteção. Separadamente, a mesma página informa que os slots auxiliares — visão, resumo da web, compressão e outros — usam provider: auto por padrão, com um model vazio, o que ela explica como usar o modelo principal para essa tarefa; assim, uma configuração recém-migrada pode cobrar tarifas de modelo principal por tarefas de segundo plano até que você substitua essa configuração.

Apontando o Hermes migrado para seu próprio endpoint

A documentação de provedores do Hermes afirma que ele funciona com qualquer endpoint de API compatível com OpenAI. A armadilha específica da migração é onde seu provedor importado é colocado: uma entrada models.providers.* do OpenClaw é gravada em custom_providers e só se torna uma entrada no dicionário canônico providers: na próxima migração de configuração hermes update. Um guia que orienta você a procurar em providers: logo após a migração está direcionando você para uma chave vazia.

# What `hermes claw migrate` writes FIRST. An OpenClaw
# `models.providers.*` entry lands under `custom_providers`,
# not under `providers:` — so check here right after migrating.
custom_providers:
  - name: kunavo
    base_url: https://api.kunavo.com/v1
    api_key: sk-your-kunavo-key
    model: claude-sonnet-4-6

# The providers doc says the legacy list is auto-migrated to the
# canonical `providers:` dict on `hermes update` (config v12). The
# documented keys of that dict are `api`, `key_env`, `transport`
# and `default_model` (`base_url`/`url` are accepted aliases of `api`).
providers:
  kunavo:
    api: https://api.kunavo.com/v1
    key_env: KUNAVO_API_KEY
    transport: chat_completions
    default_model: claude-sonnet-4-6

Três observações sobre esse bloco. O importador mapeia valores de API curtos (openai, anthropic) e com hífen (openai-completions, anthropic-messages, google-generative-ai) do OpenClaw. A própria documentação do Hermes diverge quanto ao nome do transporte — a referência de provedores lista chat_completions, anthropic_messages e codex_responses, enquanto a página de configuração de modelos escreve transport: openai_chat; use chat_completions, que é o valor fornecido pela referência dedicada de provedores, e trate openai_chat como não confirmado. Além disso, endpoints personalizados compatíveis com OpenAI não recebem no Hermes um limite automático de saída do tamanho do catálogo; portanto, defina context_length por conta própria ou forneça uma lista explícita de models: com discover_models: false se a descoberta no seu endpoint não funcionar.

Para deixar claros os limites desta página: a Kunavo publica referências de configuração para vários clientes, mas o Hermes Agent não foi testado em runtime aqui, nenhum hermes claw migrate foi executado para este artigo e não foi testado se o transporte anthropic_messages do Hermes ou sua descoberta de modelos funciona contra o endpoint da Kunavo. Mantenha uma rota funcional disponível enquanto você testa. Às tarifas do catálogo, Claude Sonnet 4.6 lista $2.10 por milhão de tokens de entrada e $10.50 por milhão de tokens de saída; o valor do catálogo da Kunavo é um piso de cobrança, não um teto, pois, quando o upstream informa sua cobrança, a conta é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. A recarga mínima é de $10 em crédito pré-pago — um mínimo de financiamento, não uma taxa por tarefa nem uma assinatura. Consulte os detalhes de cobrança e crie uma conta Kunavo quando estiver pronto para financiar uma chave.

Depois do primeiro dia, faça a conciliação. O Hermes inclui hermes insights, que a referência da CLI descreve apenas como "mostrar análises de tokens/custo/atividade" e documenta sem flags; portanto, leia hermes insights --help para saber o que sua compilação realmente aceita — e compare isso com o uso efetivamente registrado na conta do seu provedor. Se os dois valores divergirem, procure uma programação duplicada antes de procurar um erro de preço. Para conhecer o método, consulte otimização de custos de IA; para a visão de planos de cada lado, preços do Hermes Agent e preços do OpenClaw; e Hermes vs OpenClaw se você ainda não tiver decidido pela migração.

Perguntas frequentes

Documentação do Hermes Agent e do OpenClaw, referências de CLI e metadados dos repositórios verificados em 19 de setembro de 2026, contra o Hermes v0.21.3 (v2026.9.14) e o OpenClaw v2026.9.5; metadados dos repositórios verificados novamente em 21 de setembro de 2026. Cada comando, flag e caminho desta página foi consultado nas fontes oficiais; nenhuma migração foi executada e nenhuma chave da Kunavo foi apontada para qualquer um dos agentes, portanto isto não é um teste de compatibilidade. As tarifas de tokens da Kunavo vêm do catálogo atual, e todo valor em dólares é aritmética ilustrativa de tokens, não um custo medido.