Naar hoofdinhoud gaan

​
OpenClaw migreren naar een nieuwe machine

Deze gids migreert een OpenClaw Gateway van de ene machine naar de andere zonder onboarding opnieuw te doen. De migratie is conceptueel eenvoudig:
  • Kopieer de state directory ($OPENCLAW_STATE_DIR, standaard: ~/.openclaw/) — dit omvat config, authenticatie, sessies en kanaalstatus.
  • Kopieer je werkruimte (standaard ~/.openclaw/workspace/) — dit bevat je agentbestanden (geheugen, prompts, enz.).
Maar er zijn veelvoorkomende valkuilen rond profielen, rechten en gedeeltelijke kopieën.

​
Voordat je begint (wat je migreert)

​
1. Identificeer je state directory

De meeste installaties gebruiken de standaard:
  • Statusmap: ~/.openclaw/
Maar deze kan anders zijn als je gebruikt:
  • --profile <name> (wordt vaak ~/.openclaw-<profile>/)
  • OPENCLAW_STATE_DIR=/some/path
Als je het niet zeker weet, voer op de oude machine uit: 
openclaw status
Zoek in de uitvoer naar vermeldingen van OPENCLAW_STATE_DIR / profiel. Als je meerdere gateways draait, herhaal dit voor elk profiel.

​
2. Identificeer je werkruimte

Veelgebruikte standaarden:
  • ~/.openclaw/workspace/ (aanbevolen werkruimte)
  • een aangepaste map die je hebt aangemaakt
Je werkruimte is waar bestanden zoals MEMORY.md, USER.md en memory/*.md staan.

​
3. Begrijp wat je behoudt

Als je zowel de state dir als de werkruimte kopieert, behoud je:
  • Gateway-configuratie (openclaw.json)
  • Auth-profielen / API-sleutels / OAuth-tokens
  • Sessiegeschiedenis + agentstatus
  • Kanaalstatus (bijv. WhatsApp-aanmelding/sessie)
  • Je werkruimtebestanden (geheugen, Skills-notities, enz.)
Als je alleen de werkruimte kopieert (bijv. via Git), behoud je niet:
  • sessies
  • inloggegevens
  • kanaalaanmeldingen
Die staan onder $OPENCLAW_STATE_DIR.

​
Migratiestappen (aanbevolen)

​
Stap 0 — Maak een back-up (oude machine)

Stop op de oude machine eerst de Gateway zodat bestanden niet veranderen tijdens het kopiëren: 
openclaw gateway stop
(Optioneel maar aanbevolen) archiveer de state dir en werkruimte: 
# Adjust paths if you use a profile or custom locations
cd ~
tar -czf openclaw-state.tgz .openclaw

tar -czf openclaw-workspace.tgz .openclaw/workspace
Als je meerdere profielen/state dirs hebt (bijv. ~/.openclaw-main, ~/.openclaw-work), archiveer elk afzonderlijk.

​
Stap 1 — Installeer OpenClaw op de nieuwe machine

Installeer op de nieuwe machine de CLI (en Node indien nodig): In deze fase is het prima als onboarding een nieuwe ~/.openclaw/ aanmaakt — je overschrijft deze in de volgende stap.

​
Stap 2 — Kopieer de state dir + werkruimte naar de nieuwe machine

Kopieer beide:
  • $OPENCLAW_STATE_DIR (standaard ~/.openclaw/)
  • je werkruimte (standaard ~/.openclaw/workspace/)
Gemeenschappelijke benaderingen:
  • scp de tarballs en uitpakken
  • rsync -a via SSH
  • externe schijf
Zorg na het kopiëren dat:
  • Verborgen mappen zijn meegenomen (bijv. .openclaw/)
  • Bestandsrechten/ownership correct zijn voor de gebruiker die de Gateway draait

​
Stap 3 — Run Doctor (migraties + serviceherstel)

Op de nieuwe machine: 
openclaw doctor
Doctor is het “veilig en saai”-commando. Het herstelt services, past config-migraties toe en waarschuwt voor mismatches. Daarna: 
openclaw gateway restart
openclaw status

​
Veelvoorkomende valkuilen (en hoe je ze voorkomt)

​
Valkuil: profiel-/state-dir-mismatch

Als je de oude Gateway met een profiel (of OPENCLAW_STATE_DIR) draaide en de nieuwe Gateway een ander gebruikt, zie je symptomen zoals:
  • configwijzigingen die niet worden toegepast
  • kanalen die ontbreken / uitgelogd zijn
  • lege sessiegeschiedenis
Oplossing: start de Gateway/service met hetzelfde profiel/dezelfde state dir die je hebt gemigreerd en voer daarna opnieuw uit: 
openclaw doctor

​
Valkuil: alleen openclaw.json kopiëren

openclaw.json is niet genoeg. Veel providers slaan status op onder:
  • $OPENCLAW_STATE_DIR/credentials/
  • $OPENCLAW_STATE_DIR/agents/<agentId>/...
Migreer altijd de volledige map $OPENCLAW_STATE_DIR.

​
Valkuil: rechten / ownership

Als je als root hebt gekopieerd of van gebruiker bent veranderd, kan de Gateway geen referenties/sessies lezen. Oplossing: zorg dat de state dir + werkruimte eigendom zijn van de gebruiker die de Gateway draait.

​
Valkuil: migreren tussen remote/lokale modi

  • Als je UI (WebUI/TUI) naar een remote Gateway wijst, bezit de remote host de sessieopslag + werkruimte.
  • Het migreren van je laptop verplaatst de status van de remote Gateway niet.
Als je in remote-modus werkt, migreer de Gateway-host.

​
Valkuil: geheimen in back-ups

$OPENCLAW_STATE_DIR bevat geheimen (API-sleutels, OAuth-tokens, WhatsApp-referenties). Behandel back-ups als productiesecrets:
  • versleuteld opslaan
  • delen via onveilige kanalen vermijden
  • sleutels roteren als je blootstelling vermoedt

​
Verificatiechecklist

Controleer op de nieuwe machine:
  • openclaw status toont dat de Gateway draait
  • Je kanalen zijn nog verbonden (bijv. WhatsApp vereist geen her-koppeling)
  • Het dashboard opent en toont bestaande sessies
  • Je werkruimtebestanden (geheugen, configs) zijn aanwezig

​
Gerelateerd