Tutorial Migration

Van OpenClaw naar Hermes Agent: een stapsgewijze migratie

Hermes Agent

Hermes Agent

@hermesagents

May 19, 2026

8 min lezen

Als je OpenClaw hebt draaien, is Hermes Agent de opvolger ervan. Dezelfde projectlijn, dezelfde maintainers, met een hernoeming en een herontwerp erbovenop. De Hermes-installer is gebouwd om dat te herkennen — v0.14.0 levert een first-class hermes claw migrate-commando dat je bestaande OpenClaw-state in één pass importeert, met dry-run-ondersteuning en expliciete presets.

Dit is de praktische migratie-rondleiding: wat er meegaat, welke flags je hebt en de dry-run-first workflow die verrassingen voorkomt.

1. Hermes Agent installeren

De Hermes-setup-wizard detecteert ~/.openclaw automatisch en biedt aan te migreren voordat de configuratie begint. De snelste route:

bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup

Wanneer de wizard je OpenClaw-home ziet, vraagt hij of hij moet migreren. Zeg ja — maar wil je eerst exact zien wat er meegaat, sluit de wizard af en draai het migrate-commando rechtstreeks.

2. Previewen met --dry-run

Doe dit altijd eerst. Het inventariseert alles wat de migrator zou importeren, zonder iets naar schijf te schrijven:

bash
hermes claw migrate --dry-run

De output groepeert per categorie — SOUL.md, memories, skills, allowlist, messaging-configs, API-keys, TTS-assets. Lees het door. Ziet iets er verkeerd uit (een verlopen API-key die je niet wilt migreren, een persoonlijkheidsfile waar je overheen gegroeid bent), sla het bijbehorende blok over via een preset.

3. Een preset kiezen

Twee presets out of the box:

  • full (default) — alles migreren, inclusief secrets
  • user-data — alles migreren behalve API-keys; secrets vul je handmatig opnieuw in

Verhuis je naar een verse machine en wil je een schone breuk op secrets? Pak user-data:

bash
hermes claw migrate --preset user-data

Upgrade je dezelfde machine en wil je continuïteit?

bash
hermes claw migrate

4. Wat er geïmporteerd wordt

Volgens de README:

OpenClawHermes-doel
SOUL.md (persona)as-is geïmporteerd
MEMORY.md en USER.md-entriesgeïmporteerd in Hermes-memory
Skills die je zelf hebt gemaaktgekopieerd naar ~/.hermes/skills/openclaw-imports/
Command-allowlist (approval-patterns)geïmporteerd
Messaging-settings (platform-configs, allowed users, working directory)geïmporteerd
API-keys (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)geïmporteerd onder preset full
TTS-assets (workspace audio-files)geïmporteerd
Workspace-AGENTS.mdgeïmporteerd met --workspace-target

Skills van agentskills.io worden niet automatisch herinstalleerd — Hermes gaat ervan uit dat je opnieuw door de hub bladert en via hermes skills pakt wat je wilt. Dat is bewust zo: de hernoeming OpenClaw → Hermes ging gepaard met een revisie van de skills-hub (v0.14.0 voegde huggingface/skills toe als trusted default tap), en een verse selectie is schoner dan een complete carry-over.

5. Conflicten afhandelen

Heeft Hermes al settings op deze machine (bijv. omdat je hermes setup deed voordat je je herinnerde dat OpenClaw er ook stond), dan weigert het migrate-commando default te overschrijven. Twee opties:

  • --overwrite — Hermes-settings overschrijven met OpenClaw-waarden
  • Sla de conflicterende categorie over met --preset user-data als het conflict op secrets zit

Gebruik --overwrite alleen na een --dry-run die bevestigt dat de OpenClaw-waarden inderdaad zijn wat je wilt.

6. Verifiëren

bash
hermes doctor

Dit draait de post-install-health-check. Staan memories, skills, allowlist of platform-configs niet waar ze horen, dan komen er specifieke errors omhoog. Fix ze, run opnieuw, door.

Alternatief: agent-geleide migratie

Wil je liever geen CLI-flags aanraken, dan levert Hermes een openclaw-migration-skill:

bash
hermes
> /openclaw-migration

De skill loodst je interactief door dezelfde migratie, met --dry-run-previews op elke stap.

Veelgestelde vragen

Verlies ik mijn OpenClaw-data? Nee. De migrator kopieert — hij verplaatst niet. Je ~/.openclaw-directory blijft onaangeroerd. Gaat er iets mis, dan kun je rollbacken door ~/.hermes weg te halen en gewoon verder te gaan met OpenClaw.

Kan ik beide tegelijk draaien? Kortstondig wel. Ze delen aannames over HOME en gaan er allebei vanuit dat ze dezelfde memory bezitten op hetzelfde moment. Voor langduriger dual-operation handelt de community-bridge HermesClaw het draaien van OpenClaw en Hermes op hetzelfde WeChat-account af.

Breken mijn skills? Skills die je zelf hebt geschreven worden naar ~/.hermes/skills/openclaw-imports/ gekopieerd, dus die overleven de verhuizing. Skills die je van agentskills.io haalde, zitten vast aan de hub, niet aan je lokale install — herinstalleer ze via hermes skills.

Waar krijg ik hulp als er iets misgaat? Eerst hermes doctor. Daarna de Nous Research Discord of GitHub Issues — beide staan in de README gelinkt.

Verder lezen

Abonneer op updates

Community-updates over Hermes Agent-releases, nieuwe vaardigheden en integraties. Geen spam, altijd opzegbaar.