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

Maintenance

Migratiehandleiding

OpenClaw ondersteunt drie migratiepaden: importeren vanuit een ander agentsysteem, een bestaande installatie naar een nieuwe machine verplaatsen en een Plugin ter plaatse upgraden.

Importeren vanuit een ander agentsysteem

Meegeleverde migratieproviders brengen instructies, MCP-servers, Skills, modelconfiguratie en (optioneel) API-sleutels over naar OpenClaw. Plannen worden vóór elke wijziging als voorbeeld weergegeven en geheimen worden in rapporten geredigeerd. Zelfstandige openclaw migrate wordt ondersteund door een geverifieerde back-up; bij een nieuwe onboarding worden lokale artefacten in plaats daarvan eerst klaargezet en geverifieerd voordat ze worden gepubliceerd, waarbij de configuratie wordt vastgelegd vóór elke onomkeerbare externe activering.

Migreren vanuit Claude

Importeer de status van Claude Code en Claude Desktop, inclusief CLAUDE.md, MCP-servers, Skills en projectopdrachten.
Migreren vanuit Hermes

Importeer Hermes-configuratie, providers, MCP-servers, geheugen, Skills en ondersteunde .env-sleutels.

Het CLI-toegangspunt is openclaw migrate. Onboarding kan ook migratie aanbieden wanneer een bekende bron wordt gedetecteerd (openclaw onboard --flow import).

OpenClaw naar een nieuwe machine verplaatsen

Kopieer de statusmap (standaard ~/.openclaw/) en je werkruimte om het volgende te behouden:

  • Configuratie — openclaw.json en alle Gateway-instellingen.
  • Authenticatie — auth-profiles.json per agent (API-sleutels plus OAuth), evenals eventuele kanaal- of providerstatus onder credentials/.
  • Sessies — gespreksgeschiedenis en agentstatus.
  • Kanaalstatus — WhatsApp-aanmelding, Telegram-sessie en vergelijkbare gegevens.
  • Werkruimtebestanden — MEMORY.md, USER.md, Skills en prompts.

Migratiestappen

  • Stop de Gateway en maak een back-up

    Stop op de oude machine de Gateway, zodat bestanden tijdens het kopiëren niet veranderen, en archiveer vervolgens:

    bash
    openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclaw

    Als je meerdere profielen gebruikt (bijvoorbeeld ~/.openclaw-work), archiveer je elk profiel afzonderlijk.

  • Installeer OpenClaw op de nieuwe machine

    Installeer de CLI (en Node indien nodig) op de nieuwe machine. Het is geen probleem als onboarding een nieuwe ~/.openclaw/ aanmaakt — die overschrijf je in de volgende stap.

  • Kopieer de statusmap en werkruimte

    Draag het archief over via scp, rsync -a of een externe schijf en pak het vervolgens uit:

    bash
    cd ~tar -xzf openclaw-state.tgz

    Controleer of verborgen mappen zijn meegenomen en of het bestandseigendom overeenkomt met de gebruiker die de Gateway gaat uitvoeren.

  • Voer Doctor uit en verifieer

    Voer op de nieuwe machine Doctor uit om configuratiemigraties toe te passen en services te herstellen:

    bash
    openclaw doctoropenclaw gateway restartopenclaw status

    • Als Telegram of Discord de standaardterugval op omgevingsvariabelen gebruikt (TELEGRAM_BOT_TOKEN of DISCORD_BOT_TOKEN), controleer dan of .env in de gemigreerde statusmap deze sleutels bevat zonder de geheime waarden af te drukken:

    bash
    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    openclaw doctor waarschuwt ook wanneer voor een ingeschakeld standaardaccount van Telegram of Discord geen token is geconfigureerd en de bijbehorende omgevingsvariabele niet beschikbaar is voor het Doctor-proces.

    Veelvoorkomende valkuilen

    Profiel of statusmap komt niet overeen

    Als de oude Gateway --profile of OPENCLAW_STATE_DIR gebruikte en de nieuwe dat niet doet, lijken kanalen afgemeld en zijn sessies leeg. Start de Gateway met hetzelfde profiel of dezelfde statusmap die je hebt gemigreerd en voer vervolgens openclaw doctor opnieuw uit.

    Alleen openclaw.json kopiëren

    Alleen het configuratiebestand is niet genoeg. Profielen voor modelauthenticatie bevinden zich onder agents/<agentId>/agent/auth-profiles.json, en de status van kanalen en providers bevindt zich onder credentials/. Migreer altijd de volledige statusmap.

    Machtigingen en eigendom

    Als je als root hebt gekopieerd of van gebruiker bent gewisseld, kan de Gateway mogelijk geen referenties lezen. Zorg ervoor dat de statusmap en werkruimte eigendom zijn van de gebruiker die de Gateway uitvoert.

    Externe modus

    Als je gebruikersinterface naar een externe Gateway verwijst, beheert de externe host de sessies en werkruimte. Migreer de Gateway-host zelf, niet je lokale laptop. Zie Veelgestelde vragen.

    Geheimen in back-ups

    De statusmap bevat authenticatieprofielen, kanaalreferenties en andere providerstatus. Sla back-ups versleuteld op, vermijd onbeveiligde overdrachtskanalen en roteer sleutels als je vermoedt dat ze zijn blootgesteld.

    Verificatiechecklist

    Controleer op de nieuwe machine het volgende:

    • [ ] openclaw status geeft aan dat de Gateway actief is.
    • [ ] Kanalen zijn nog steeds verbonden (opnieuw koppelen is niet nodig).
    • [ ] Het dashboard wordt geopend en toont bestaande sessies.
    • [ ] Werkruimtebestanden (geheugen, configuraties) zijn aanwezig.

    Een Plugin ter plaatse upgraden

    Bij upgrades van een Plugin ter plaatse blijven dezelfde Plugin-id en configuratiesleutels behouden, maar kan de status op schijf naar de huidige indeling worden verplaatst. Pluginspecifieke upgradehandleidingen staan naast de bijbehorende kanalen:

    • Matrix-migratie: beperkingen voor herstel van versleutelde status, gedrag voor automatische momentopnamen en handmatige herstelopdrachten.

    Gerelateerd

    Was this useful?
    On this page

    On this page