Mise à jour¶

OpenClaw évolue rapidement (pré « 1.0 »). Traitez les mises à jour comme de l’infrastructure en production : mise à jour → exécuter les vérifications → redémarrer (ou utiliser openclaw update, qui redémarre) → vérifier.

Recommandé : relancer l’installateur du site web (mise à niveau sur place)¶

Le chemin de mise à jour préféré consiste à relancer l’installateur depuis le site web. Il détecte les installations existantes, met à niveau sur place et exécute openclaw doctor si nécessaire.

curl -fsSL https://openclaw.ai/install.sh | bash

Notes :

• Ajoutez --no-onboard si vous ne voulez pas relancer l’assistant de prise en main.

• Pour les installations depuis la source, utilisez :

bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard

L’installateur effectuera git pull --rebase uniquement si le dépôt est propre.

• Pour les installations globales, le script utilise npm install -g openclaw@latest en interne.

• Note héritage : clawdbot reste disponible comme shim de compatibilité.

Avant de mettre à jour¶

• Sachez comment vous avez installé : global (npm/pnpm) vs depuis la source (git clone).
• Sachez comment votre Gateway (passerelle) s’exécute : terminal au premier plan vs service supervisé (launchd/systemd).
• Instantané votre adaptation :
• Config : ~/.openclaw/openclaw.json
• Identifiants : ~/.openclaw/credentials/
• Espace de travail : ~/.openclaw/workspace

Mise à jour (installation globale)¶

Installation globale (choisissez une option) :

npm i -g openclaw@latest

pnpm add -g openclaw@latest

Nous ne recommandons pas Bun pour l’exécution de la Gateway (passerelle) (bogues WhatsApp/Telegram).

Pour changer de canal de mise à jour (installations git + npm) :

openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable

Utilisez --tag <dist-tag|version> pour une installation ponctuelle avec un tag/version.

Voir Canaux de développement pour la sémantique des canaux et les notes de version.

Note : pour les installations npm, la gateway journalise un indice de mise à jour au démarrage (vérifie le tag du canal courant). Désactivez via update.checkOnStart: false.

Puis :

openclaw doctor
openclaw gateway restart
openclaw health

Notes :

• Si votre Gateway (passerelle) s’exécute comme un service, openclaw gateway restart est préférable à l’arrêt manuel des PID.
• Si vous êtes épinglé à une version spécifique, voir « Retour arrière / épinglage » ci‑dessous.

Mise à jour (openclaw update)¶

Pour les installations depuis la source (git checkout), privilégiez :

openclaw update

Cela exécute un flux de mise à jour « plutôt sûr » :

• Exige un arbre de travail propre.
• Bascule vers le canal sélectionné (tag ou branche).
• Récupère + rebase sur l’amont configuré (canal dev).
• Installe les dépendances, compile, construit l’UI de contrôle et exécute openclaw doctor.
• Redémarre la gateway par défaut (utilisez --no-restart pour ignorer).

Si vous avez installé via npm/pnpm (sans métadonnées git), openclaw update tentera de mettre à jour via votre gestionnaire de paquets. S’il ne peut pas détecter l’installation, utilisez plutôt « Mise à jour (installation globale) ».

Mise à jour (UI de contrôle / RPC)¶

L’UI de contrôle propose Update & Restart (RPC : update.run). Elle :

1. Exécute le même flux de mise à jour depuis la source que openclaw update (git checkout uniquement).
2. Écrit un sentinelle de redémarrage avec un rapport structuré (fin de stdout/stderr).
3. Redémarre la gateway et notifie la dernière session active avec le rapport.

Si le rebase échoue, la gateway abandonne et redémarre sans appliquer la mise à jour.

Mise à jour (depuis la source)¶

Depuis le checkout du dépôt :

Préféré :

openclaw update

Manuel (équivalent-ish) :

git pull
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw doctor
openclaw health

Notes :

• pnpm build compte lorsque vous exécutez le binaire openclaw empaqueté (openclaw.mjs) ou utilisez Node pour exécuter dist/.
• Si vous exécutez depuis un checkout du dépôt sans installation globale, utilisez pnpm openclaw ... pour les commandes CLI.
• Si vous exécutez directement depuis TypeScript (pnpm openclaw ...), une reconstruction est généralement inutile, mais les migrations de configuration s’appliquent toujours → exécutez doctor.
• Passer d’installations globales à git (et inversement) est simple : installez l’autre variante, puis exécutez openclaw doctor afin que le point d’entrée du service gateway soit réécrit vers l’installation courante.

À exécuter systématiquement : openclaw doctor¶

Doctor est la commande de « mise à jour sûre ». Elle est volontairement ennuyeuse : réparer + migrer + avertir.

Note : si vous êtes sur une installation depuis la source (git checkout), openclaw doctor proposera d’exécuter openclaw update d’abord.

Actions typiques :

• Migrer les clés de configuration obsolètes / emplacements de fichiers de configuration hérités.
• Auditer les politiques de Messages prives et avertir des réglages « ouverts » risqués.
• Vérifier l’état de la Gateway (passerelle) et proposer un redémarrage.
• Détecter et migrer d’anciens services gateway (launchd/systemd ; anciens schtasks) vers les services OpenClaw actuels.
• Sous Linux, s’assurer du lingering utilisateur systemd (pour que la Gateway survive à la déconnexion).

Détails : Doctor

Démarrer / arrêter / redémarrer la Gateway (passerelle)¶

CLI (fonctionne quel que soit l’OS) :

openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow

Si vous êtes supervisé :

• macOS launchd (LaunchAgent empaqueté dans l’app) : launchctl kickstart -k gui/$UID/bot.molt.gateway (utilisez bot.molt.<profile> ; l’historique com.openclaw.* fonctionne encore)
• Linux systemd user service : systemctl --user restart openclaw-gateway[-<profile>].service
• Windows (WSL2) : systemctl --user restart openclaw-gateway[-<profile>].service
• launchctl/systemctl ne fonctionnent que si le service est installé ; sinon exécutez openclaw gateway install.

Runbook + libellés exacts des services : Runbook de la Gateway

Retour arrière / épinglage (quand quelque chose se casse)¶

Épingler (installation globale)¶

Installez une version connue comme fonctionnelle (remplacez <version> par la dernière qui marchait) :

npm i -g openclaw@<version>

pnpm add -g openclaw@<version>

Astuce : pour voir la version actuellement publiée, exécutez npm view openclaw version.

Puis redémarrez + relancez doctor :

openclaw doctor
openclaw gateway restart

Épingler (source) par date¶

Choisissez un commit à une date donnée (exemple : « état de main au 2026‑01‑01 ») :

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"

Puis réinstallez les dépendances + redémarrez :

pnpm install
pnpm build
openclaw gateway restart

Si vous voulez revenir au plus récent plus tard :

git checkout main
git pull

Si vous êtes bloqué¶

• Exécutez à nouveau openclaw doctor et lisez attentivement la sortie (elle indique souvent la correction).
• Consultez : Depannage
• Demandez sur Discord : https://discord.gg/clawd