OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Migreren vanuit Hermes

De meegeleverde Hermes-migratieprovider detecteert de status in ~/.hermes, toont een voorbeeld van elke wijziging voordat deze wordt toegepast, maskeert geheimen in plannen en rapporten en schrijft een geverifieerde OpenClaw-back-up voordat er iets wordt gewijzigd.

Twee manieren om te importeren

Onboardingwizard

Detecteert Hermes in ~/.hermes en toont een voorbeeld voordat de wijzigingen worden toegepast.

bash
openclaw onboard --flow import

Of verwijs naar een specifieke bron:

bash
openclaw onboard --import-from hermes --import-source ~/.hermes

CLI

Gebruik openclaw migrate voor gescripte of herhaalbare uitvoeringen. Zie openclaw migrate voor de volledige referentie.

bash
openclaw migrate hermes --dry-run    # alleen voorbeeldopenclaw migrate apply hermes --yes  # toepassen zonder bevestiging

Voeg --from <path> toe wanneer Hermes zich buiten ~/.hermes bevindt.

Wat wordt geïmporteerd

Modelconfiguratie
  • De standaardmodelselectie uit het Hermes-bestand config.yaml.
  • Geconfigureerde modelproviders en aangepaste OpenAI-compatibele eindpunten uit providers en custom_providers.
MCP-servers

MCP-serverdefinities uit mcp_servers of mcp.servers.

Werkruimtebestanden
  • SOUL.md en AGENTS.md worden naar de OpenClaw-agentwerkruimte gekopieerd.
  • memories/MEMORY.md en memories/USER.md worden aan de overeenkomende OpenClaw-geheugenbestanden toegevoegd in plaats van deze te overschrijven.
Geheugenconfiguratie

Standaardwaarden voor de geheugenconfiguratie van het OpenClaw-bestandsgeheugen. Externe geheugenproviders zoals Honcho worden geregistreerd als archiefitems of items voor handmatige controle, zodat je ze doelbewust kunt verplaatsen.

Skills

Skills met een SKILL.md-bestand onder skills/<name>/ worden gekopieerd, samen met configuratiewaarden per Skill uit skills.config.

Authenticatiegegevens

Interactieve uitvoering van openclaw migrate vraagt vóór het importeren van authenticatiegegevens om bevestiging, waarbij ja standaard is geselecteerd. Als je dit accepteert, worden OpenCode OpenAI OAuth- en GitHub Copilot-vermeldingen uit het bestand auth.json van OpenCode geïmporteerd, evenals de ondersteunde Hermes-sleutels voor .env. De OAuth-vermeldingen in het eigen auth.json-bestand van Hermes zijn verouderde status: ze worden weergegeven als een item voor handmatige herauthenticatie of reparatie met doctor, in plaats van naar actieve authenticatie te worden geïmporteerd. Gebruik --include-secrets om aanmeldgegevens tijdens een niet-interactieve uitvoering te importeren, --no-auth-credentials om de import van aanmeldgegevens volledig over te slaan, of de vlag --import-secrets van de onboardingwizard.

Wat uitsluitend in het archief blijft

De provider kopieert het volgende naar de map met migratierapporten voor handmatige controle, maar laadt dit niet in de actieve OpenClaw-configuratie of aanmeldgegevens:

  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db

OpenClaw weigert deze status automatisch uit te voeren of te vertrouwen, omdat indelingen en vertrouwensaannamen tussen systemen kunnen verschillen. Verplaats wat je nodig hebt handmatig nadat je het archief hebt gecontroleerd.

Aanbevolen procedure

  • Bekijk een voorbeeld van het plan

    bash
    openclaw migrate hermes --dry-run

    Het plan vermeldt alles wat wordt gewijzigd, waaronder conflicten, overgeslagen items en gevoelige items. Geneste sleutels die op geheimen lijken, worden in de uitvoer gemaskeerd.

  • Pas toe met een back-up

    bash
    openclaw migrate apply hermes --yes

    OpenClaw maakt en verifieert vóór het toepassen een back-up. Dit niet-interactieve voorbeeld importeert alleen niet-geheime status. Voer de opdracht zonder --yes uit om de vraag over aanmeldgegevens interactief te beantwoorden, of voeg --include-secrets toe om ondersteunde aanmeldgegevens tijdens een onbeheerde uitvoering op te nemen.

  • Voer doctor uit

    bash
    openclaw doctor

    Doctor past eventuele openstaande configuratiemigraties opnieuw toe en controleert op problemen die tijdens de import zijn ontstaan.

  • Herstart en verifieer

    bash
    openclaw gateway restartopenclaw status

    Controleer of de Gateway correct werkt en of je geïmporteerde model, geheugen en Skills zijn geladen.

    • Conflictafhandeling

    Het toepassen weigert door te gaan wanneer het plan conflicten meldt (een bestand of configuratiewaarde bestaat al op de doellocatie).

    Conflicten zijn ongebruikelijk bij een nieuwe installatie. Ze treden doorgaans op wanneer je de import opnieuw uitvoert voor een configuratie die al gebruikerswijzigingen bevat.

    Als tijdens het toepassen een conflict optreedt (bijvoorbeeld een onverwachte racecondition bij een configuratiebestand), markeert Hermes de resterende afhankelijke configuratie-items als skipped met de reden blocked by earlier apply conflict, in plaats van deze gedeeltelijk te schrijven. Het migratierapport registreert elk geblokkeerd item, zodat je het oorspronkelijke conflict kunt oplossen en de import opnieuw kunt uitvoeren.

    Geheimen

    Interactieve uitvoering van openclaw migrate vraagt of gedetecteerde authenticatiegegevens moeten worden geïmporteerd, waarbij ja standaard is geselecteerd.

    • Als je dit accepteert, worden OpenCode OpenAI OAuth- en GitHub Copilot-vermeldingen uit het bestand auth.json van OpenCode geïmporteerd, evenals de ondersteunde sleutels voor .env. De OAuth-vermeldingen in het eigen auth.json-bestand van Hermes worden gemeld voor handmatige herauthenticatie bij OpenAI of reparatie met doctor.
    • Gebruik --no-auth-credentials, of antwoord nee op de vraag, om alleen niet-geheime status te importeren.
    • Gebruik --include-secrets om aanmeldgegevens tijdens een onbeheerde uitvoering met --yes te importeren.
    • Gebruik de vlag --import-secrets van de onboardingwizard om aanmeldgegevens vanuit de wizard te importeren.

    JSON-uitvoer voor automatisering

    bash
    openclaw migrate hermes --dry-run --jsonopenclaw migrate apply hermes --json --yes

    Met --json en zonder --yes drukt het toepassen het plan af en wordt de status niet gewijzigd: dit is de veiligste modus voor CI en gedeelde scripts.

    Probleemoplossing

    Toepassen wordt geweigerd vanwege conflicten

    Controleer de uitvoer van het plan. Elk conflict identificeert het bronpad en het bestaande doel. Bepaal per item of je het wilt overslaan, het doel wilt bewerken of de opdracht opnieuw wilt uitvoeren met --overwrite.

    Hermes bevindt zich buiten ~/.hermes

    Geef --from /actual/path (CLI) of --import-source /actual/path (onboarding) door.

    Onboarding weigert te importeren naar een bestaande configuratie

    Voor onboardingimports is een nieuwe configuratie vereist. Stel de status opnieuw in en doorloop de onboarding opnieuw, of gebruik rechtstreeks openclaw migrate apply hermes, dat --overwrite en expliciet back-upbeheer ondersteunt.

    API-sleutels zijn niet geïmporteerd

    Interactieve uitvoering van openclaw migrate importeert API-sleutels alleen wanneer je de vraag over aanmeldgegevens accepteert. Niet-interactieve uitvoeringen met --yes hebben --include-secrets nodig; onboardingimports hebben --import-secrets nodig. Alleen de ondersteunde sleutels voor .env worden herkend; andere variabelen in .env worden genegeerd.

    Gerelateerd

    • openclaw migrate: volledige CLI-referentie, Plugin-contract en JSON-structuren.
    • Onboarding: wizardprocedure en vlaggen voor niet-interactief gebruik.
    • Migreren: verplaats een OpenClaw-installatie tussen machines.
    • Doctor: statuscontrole na de migratie.
    • Agentwerkruimte: waar SOUL.md, AGENTS.md en geheugenbestanden zich bevinden.
    Was this useful?
    On this page

    On this page