Skip to main content

​
Updaten

OpenClaw ontwikkelt zich snel (pre “1.0”). Behandel updates als het uitrollen van infrastructuur: update → controles uitvoeren → herstarten (of gebruik openclaw update, dat herstart) → verifiëren.

​
Aanbevolen: de website‑installer opnieuw uitvoeren (in‑place upgrade)

Het voorkeursupdatepad is het opnieuw uitvoeren van de installer vanaf de website. Deze detecteert bestaande installaties, voert een in‑place upgrade uit en draait openclaw doctor wanneer nodig.
Notities:
  • Voeg --no-onboard toe als je niet wilt dat de onboarding‑wizard opnieuw wordt gestart.
  • Voor broninstallaties, gebruik:
    De installer zal git pull --rebase alleen uitvoeren als de repo schoon is.
  • Voor globale installaties gebruikt het script onder de motorkap npm install -g openclaw@latest.
  • Legacy‑notitie: clawdbot blijft beschikbaar als compatibiliteits‑shim.

​
Vóór je update

  • Weet hoe je hebt geïnstalleerd: globaal (npm/pnpm) vs vanuit bron (git clone).
  • Weet hoe je Gateway draait: voorgrondterminal vs beheerde service (launchd/systemd).
  • Maak een snapshot van je maatwerk:
    • Configuratie: ~/.openclaw/openclaw.json
    • Inloggegevens: ~/.openclaw/credentials/
    • Werkruimte: ~/.openclaw/workspace

​
Update (globale installatie)

Globale installatie (kies er één):
We raden Bun niet aan voor de Gateway‑runtime (WhatsApp/Telegram‑bugs). Om updatekanalen te wisselen (git‑ en npm‑installaties):
Gebruik --tag <dist-tag|version> voor een eenmalige installatietag/versie. Zie Development channels voor kanaalsemantiek en release‑notes. Let op: bij npm‑installaties logt de gateway bij het opstarten een update‑hint (controleert de huidige kanaaltag). Uitschakelen via update.checkOnStart: false. Daarna:
Notities:
  • Als je Gateway als service draait, heeft openclaw gateway restart de voorkeur boven het killen van PID’s.
  • Als je vastgepind bent op een specifieke versie, zie “Rollback / pinning” hieronder.

​
Bijwerken (openclaw update)

Voor broninstallaties (git checkout) heeft de voorkeur:
Dit draait een veilig‑achtige updateflow:
  • Vereist een schone worktree.
  • Schakelt over naar het geselecteerde kanaal (tag of branch).
  • Haalt op + rebase tegen de geconfigureerde upstream (dev‑kanaal).
  • Installeert dependencies, bouwt, bouwt de Control UI en draait openclaw doctor.
  • Herstart standaard de gateway (gebruik --no-restart om over te slaan).
Als je via npm/pnpm hebt geïnstalleerd (geen git‑metadata), zal openclaw update proberen te updaten via je package manager. Als de installatie niet kan worden gedetecteerd, gebruik dan “Update (globale installatie)”.

​
Bijwerken (Control UI / RPC)

De Control UI heeft Update & Restart (RPC: update.run). Deze:
  1. Draait dezelfde bron‑updateflow als openclaw update (alleen git checkout).
  2. Schrijft een herstart‑sentinel met een gestructureerd rapport (stdout/stderr‑tail).
  3. Herstart de gateway en pingt de laatst actieve sessie met het rapport.
Als de rebase faalt, breekt de gateway af en herstart zonder de update toe te passen.

​
Update (vanuit bron)

Vanuit de repo‑checkout: Voorkeur:
Handmatig (ongeveer equivalent):
Notities:
  • pnpm build is belangrijk wanneer je de verpakte openclaw‑binary (openclaw.mjs) draait of Node gebruikt om dist/ te starten.
  • Als je vanuit een repo‑checkout draait zonder globale installatie, gebruik pnpm openclaw ... voor CLI‑opdrachten.
  • Als je direct vanuit TypeScript draait (pnpm openclaw ...), is een rebuild meestal niet nodig, maar config‑migraties zijn nog steeds van toepassing → draai doctor.
  • Wisselen tussen globale en git‑installaties is eenvoudig: installeer de andere variant en draai vervolgens openclaw doctor zodat het gateway‑service‑entrypoint wordt herschreven naar de huidige installatie.

​
Altijd uitvoeren: openclaw doctor

Doctor is de “veilige update”‑opdracht. Hij is bewust saai: repareren + migreren + waarschuwen. Let op: als je op een broninstallatie zit (git checkout), zal openclaw doctor aanbieden om eerst openclaw update uit te voeren. Typische zaken die hij doet:
  • Migreren van verouderde config‑sleutels / legacy config‑bestandslocaties.
  • DM‑beleid auditen en waarschuwen bij risicovolle “open” instellingen.
  • Gateway‑gezondheid controleren en eventueel een herstart voorstellen.
  • Oudere gateway‑services detecteren en migreren (launchd/systemd; legacy schtasks) naar huidige OpenClaw‑services.
  • Op Linux: systemd user lingering afdwingen (zodat de Gateway na uitloggen blijft draaien).
Details: Doctor

​
Starten / stoppen / herstarten van de Gateway

CLI (werkt ongeacht OS):
Als je beheerd draait:
  • macOS launchd (app‑gebundelde LaunchAgent): launchctl kickstart -k gui/$UID/bot.molt.gateway (gebruik bot.molt.<profile>; legacy com.openclaw.* werkt nog steeds)
  • Linux systemd-gebruikersservice: systemctl --user restart openclaw-gateway[-<profile>].service
  • Windows (WSL2): systemctl --user restart openclaw-gateway[-<profile>].service
    • launchctl/systemctl werken alleen als de service is geïnstalleerd; anders draai openclaw gateway install.
Runbook + exacte servicelabels: Gateway runbook

​
Rollback / pinning (wanneer iets breekt)

​
Pinnen (globale installatie)

Installeer een bekende goede versie (vervang <version> door de laatst werkende):
Tip: om de huidige gepubliceerde versie te zien, draai npm view openclaw version. Herstart daarna + draai doctor opnieuw:

​
Pinnen (bron) op datum

Kies een commit op basis van een datum (voorbeeld: “status van main per 2026‑01‑01”):
Installeer daarna dependencies opnieuw + herstart:
Als je later terug wilt naar de nieuwste versie:

​
Als je vastzit