Naar hoofdinhoud gaan
OpenClaw importeert Hermes-status via een gebundelde migratieprovider. De provider toont een voorbeeld van alles voordat de status wordt gewijzigd, redigeert geheimen in plannen en rapporten, en maakt een geverifieerde back-up voordat de toepassing begint.
Imports vereisen een nieuwe OpenClaw-installatie. Als je al lokale OpenClaw-status hebt, reset dan eerst configuratie, referenties, sessies en de werkruimte, of gebruik openclaw migrate rechtstreeks met --overwrite nadat je het plan hebt gecontroleerd.

​
Twee manieren om te importeren

Het snelste pad. De wizard detecteert Hermes op ~/.hermes en toont een voorbeeld voordat wijzigingen worden toegepast.
openclaw onboard --flow import
Of wijs naar een specifieke bron:
openclaw onboard --import-from hermes --import-source ~/.hermes

​
Wat wordt geïmporteerd

  • Standaardmodelselectie uit Hermes config.yaml.
  • Geconfigureerde modelproviders en aangepaste OpenAI-compatibele endpoints uit providers en custom_providers.
MCP-serverdefinities uit mcp_servers of mcp.servers.
  • SOUL.md en AGENTS.md worden naar de OpenClaw-agentwerkruimte gekopieerd.
  • memories/MEMORY.md en memories/USER.md worden toegevoegd aan de overeenkomende OpenClaw-geheugenbestanden in plaats van ze te overschrijven.
Standaardwaarden voor geheugenconfiguratie voor OpenClaw-bestandsgeheugen. Externe geheugenproviders zoals Honcho worden geregistreerd als archief- of handmatige-reviewitems, zodat je ze bewust kunt verplaatsen.
Skills met een SKILL.md-bestand onder skills/<name>/ worden gekopieerd, samen met configuratiewaarden per Skill uit skills.config.
Interactieve openclaw migrate vraagt voordat authenticatiereferenties worden geïmporteerd, waarbij ja standaard is geselecteerd. Geaccepteerde imports omvatten OpenCode OpenAI OAuth-referenties uit OpenCode auth.json, OpenCode- en GitHub Copilot-vermeldingen uit OpenCode auth.json, en de ondersteunde .env-sleutels. Hermes auth.json OAuth-vermeldingen zijn legacy-status en worden weergegeven als handmatige herauthenticatie-/doctorwerk in plaats van geïmporteerd in live-authenticatie. Gebruik --include-secrets voor niet-interactieve import van referenties met openclaw migrate, --no-auth-credentials om dit over te slaan, of onboarding --import-secrets bij importeren vanuit de onboardingwizard.

​
Wat alleen archief blijft

De provider kopieert deze naar de migratierapportmap voor handmatige review, maar laadt ze niet in live OpenClaw-configuratie of referenties:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw weigert deze status automatisch uit te voeren of te vertrouwen, omdat de formaten en vertrouwensaannames tussen systemen kunnen afwijken. Verplaats wat je nodig hebt handmatig nadat je het archief hebt gecontroleerd.

​
Aanbevolen flow

1

Bekijk het plan vooraf

openclaw migrate hermes --dry-run
Het plan vermeldt alles wat zal veranderen, inclusief conflicten, overgeslagen items en eventuele gevoelige items. Planuitvoer redigeert geneste sleutels die op geheimen lijken.
2

Pas toe met back-up

openclaw migrate apply hermes --yes
OpenClaw maakt en verifieert een back-up voordat wijzigingen worden toegepast. Dit niet-interactieve voorbeeld importeert niet-geheime status. Voer uit zonder --yes om de referentieprompt te beantwoorden, of voeg --include-secrets toe om ondersteunde referenties op te nemen in onbeheerde runs.
3

Voer doctor uit

openclaw doctor
Doctor past eventuele openstaande configuratiemigraties opnieuw toe en controleert op problemen die tijdens de import zijn geïntroduceerd.
4

Herstart en verifieer

openclaw gateway restart
openclaw status
Bevestig dat de Gateway gezond is en dat je geïmporteerde model, geheugen en Skills zijn geladen.

​
Conflictafhandeling

Apply weigert door te gaan wanneer het plan conflicten meldt (een bestand of configuratiewaarde bestaat al op het doel).
Voer opnieuw uit met --overwrite alleen wanneer het vervangen van het bestaande doel opzettelijk is. Providers kunnen nog steeds back-ups op itemniveau schrijven voor overschreven bestanden in de migratierapportmap.
Voor een nieuwe OpenClaw-installatie zijn conflicten ongebruikelijk. Ze verschijnen meestal wanneer je de import opnieuw uitvoert op een installatie die al gebruikersbewerkingen bevat. Als er halverwege apply een conflict optreedt (bijvoorbeeld een onverwachte race op een configuratiebestand), markeert Hermes resterende afhankelijke configuratie-items als skipped met reden blocked by earlier apply conflict in plaats van ze gedeeltelijk te schrijven. Het migratierapport registreert elk geblokkeerd item, zodat je het oorspronkelijke conflict kunt oplossen en de import opnieuw kunt uitvoeren.

​
Geheimen

Interactieve openclaw migrate vraagt of gedetecteerde authenticatiereferenties moeten worden geïmporteerd, waarbij ja standaard is geselecteerd.
  • Het accepteren van de prompt importeert OpenCode OpenAI OAuth-referenties uit OpenCode auth.json, OpenCode- en GitHub Copilot-vermeldingen uit OpenCode auth.json, en de ondersteunde .env-sleutels. Hermes auth.json OAuth-vermeldingen worden gerapporteerd voor handmatige OpenAI-herauthenticatie of doctorherstel.
  • Gebruik --no-auth-credentials of kies nee bij de prompt om alleen niet-geheime status te importeren.
  • Gebruik --include-secrets wanneer je onbeheerd uitvoert met --yes.
  • Gebruik onboarding --import-secrets wanneer je referenties importeert vanuit de onboardingwizard.
  • Configureer voor door SecretRef beheerde referenties de SecretRef-bron nadat de import is voltooid.

​
JSON-uitvoer voor automatisering

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
Met --json en zonder --yes drukt apply het plan af en muteert het geen status. Dit is de veiligste modus voor CI en gedeelde scripts.

​
Probleemoplossing

Inspecteer de planuitvoer. Elk conflict identificeert het bronpad en het bestaande doel. Bepaal per item of je het overslaat, het doel bewerkt, of opnieuw uitvoert met --overwrite.
Geef --from /actual/path (CLI) of --import-source /actual/path (onboarding) door.
Onboardingimports vereisen een nieuwe installatie. Reset de status en onboard opnieuw, of gebruik openclaw migrate apply hermes rechtstreeks; dit ondersteunt --overwrite en expliciete back-upcontrole.
Interactieve openclaw migrate importeert API-sleutels alleen wanneer je de referentieprompt accepteert. Niet-interactieve --yes-runs vereisen --include-secrets; onboardingimports vereisen --import-secrets. Alleen de ondersteunde .env-sleutels worden herkend; andere variabelen in .env worden genegeerd.

​
Gerelateerd

  • openclaw migrate: volledige CLI-referentie, Plugin-contract en JSON-vormen.
  • Onboarding: wizardflow en niet-interactieve flags.
  • Migreren: verplaats een OpenClaw-installatie tussen machines.
  • Doctor: gezondheidscontrole na migratie.
  • Agentwerkruimte: waar SOUL.md, AGENTS.md en geheugenbestanden staan.