Mise à jour

Maintenez OpenClaw à jour.

Pour le remplacement des images Docker, Podman et Kubernetes, consultez Mettre à niveau les images de conteneur. Le Gateway exécute les opérations de mise à niveau sûres au démarrage avant d’être prêt et s’arrête si l’état monté nécessite une réparation manuelle.

Recommandé : openclaw update

Détecte votre type d’installation (npm ou git), récupère la dernière version, exécute openclaw doctor et redémarre le Gateway.

openclaw update

Changez de canal ou ciblez une version précise :

openclaw update --channel betaopenclaw update --channel extended-stableopenclaw update --channel devopenclaw update --dry-run   # aperçu sans application

openclaw update ne possède pas d’option --verbose (contrairement au programme d’installation). Pour le diagnostic, utilisez --dry-run afin de prévisualiser les actions prévues, --json pour obtenir des résultats structurés, ou openclaw update status --json pour examiner l’état du canal et des versions disponibles.

--channel beta privilégie le dist-tag npm bêta, mais se rabat sur stable/latest si le tag bêta est absent ou si sa version est antérieure à la dernière version stable. Utilisez plutôt --tag beta pour une mise à jour ponctuelle du paquet épinglée directement sur le dist-tag npm bêta.

--channel extended-stable est réservé aux paquets, et l’installation reste exclusivement au premier plan. OpenClaw lit le sélecteur npm public extended-stable, vérifie le paquet exact sélectionné et installe cette version précise. Des données de registre absentes ou incohérentes provoquent un échec sans solution de repli ; le système ne se rabat jamais sur latest. Si la version sélectionnée est antérieure à la version installée, la confirmation habituelle de rétrogradation reste nécessaire. La CLI enregistre le canal après une mise à jour réussie du cœur ; une commande directe npm install -g openclaw@extended-stable ne met pas à jour update.channel. Après le remplacement du cœur, les plugins npm officiels admissibles ayant une intention nue/par défaut ou latest convergent vers cette version exacte du cœur. Les épinglages exacts et les tags explicites autres que latest, les plugins tiers et les sources autres que npm restent inchangés. Les installations depuis le catalogue créées par les versions actuelles d’OpenClaw conservent cette intention par défaut. Les anciens enregistrements qui contiennent uniquement une version exacte restent épinglés, car OpenClaw ne peut pas distinguer de manière fiable un ancien épinglage automatique d’un épinglage utilisateur ; exécutez une fois openclaw plugins update @openclaw/name sur le canal extended-stable pour réintégrer ce plugin au suivi exact de la version du cœur.

--channel dev fournit une copie de travail GitHub main mobile et persistante. Pour une mise à jour ponctuelle du paquet, --tag main correspond à la spécification de paquet github:openclaw/openclaw#main et l’installe directement avec le gestionnaire de paquets cible (npm/pnpm/bun).

Pour les plugins gérés, l’absence d’une version bêta produit un avertissement et non un échec : la mise à jour du cœur peut tout de même réussir tandis qu’un plugin se rabat sur sa version enregistrée par défaut/latest.

Consultez Canaux de publication pour connaître la sémantique des canaux.

Basculer entre les installations npm et git

Utilisez les canaux pour changer le type d’installation. Le programme de mise à jour conserve votre état, votre configuration, vos identifiants et votre espace de travail dans ~/.openclaw ; il modifie uniquement l’installation du code OpenClaw utilisée par la CLI et le Gateway.

# installation du paquet npm -> copie de travail git modifiableopenclaw update --channel dev # copie de travail git -> installation du paquet npmopenclaw update --channel stable

Prévisualisez d’abord le changement de mode d’installation :

openclaw update --channel dev --dry-runopenclaw update --channel stable --dry-run

dev garantit la présence d’une copie de travail git, la compile et installe la CLI globale depuis cette copie de travail. Les canaux stable, extended-stable et beta utilisent des installations de paquets. Extended-stable est refusé sur une copie de travail git sans la modifier ni la convertir. Si le Gateway est déjà installé, openclaw update actualise les métadonnées du service et le redémarre, sauf si vous transmettez --no-restart.

Pour les installations de paquets dotées d’un service Gateway géré, openclaw update cible la racine du paquet utilisée par ce service. Si la commande d’interpréteur openclaw provient d’une autre installation, le programme de mise à jour affiche les deux racines ainsi que le chemin de Node du service géré, puis vérifie cette version de Node par rapport à l’exigence engines.node de la version cible avant de remplacer le paquet.

Alternative : relancer le programme d’installation

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

Ajoutez --no-onboard pour ignorer l’intégration initiale. Pour imposer un type d’installation précis, transmettez --install-method git --no-onboard ou --install-method npm --no-onboard.

Si openclaw update échoue après la phase d’installation du paquet npm, relancez plutôt le programme d’installation. Celui-ci n’appelle pas le programme de mise à jour ; il exécute directement l’installation globale du paquet et peut restaurer une installation npm partiellement mise à jour.

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

Épinglez la restauration sur une version ou un dist-tag précis avec --version :

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

Alternative : utilisation manuelle de npm, pnpm ou bun

npm i -g openclaw@latest

Privilégiez openclaw update pour les installations supervisées : cette commande peut coordonner le remplacement du paquet avec le service Gateway en cours d’exécution. Si vous effectuez une mise à jour manuelle sur une installation supervisée, arrêtez d’abord le Gateway géré. Les gestionnaires de paquets remplacent les fichiers sur place, et un Gateway en cours d’exécution pourrait autrement tenter de charger des fichiers du cœur ou de plugins pendant le remplacement. Redémarrez le Gateway une fois le gestionnaire de paquets terminé afin qu’il utilise la nouvelle installation.

Pour une installation Linux globale appartenant à root, si openclaw update échoue avec EACCES, effectuez la restauration avec le npm système tout en maintenant le Gateway arrêté pendant le remplacement manuel. Utilisez les mêmes options de profil et le même environnement que ceux que vous employez habituellement pour ce Gateway. Remplacez /usr/bin/npm par le npm système qui possède le préfixe global appartenant à root sur votre hôte :

openclaw gateway stopsudo /usr/bin/npm i -g openclaw@latestopenclaw gateway install --forceopenclaw gateway restart

Vérifiez ensuite :

openclaw --versioncurl -fsS http://127.0.0.1:18789/readyzopenclaw plugins list --jsonopenclaw gateway status --deep --jsonopenclaw doctor --lint --json

Lorsque openclaw update gère une installation npm globale, il installe d’abord la cible dans un préfixe npm temporaire, vérifie l’inventaire dist du paquet, puis remplace l’arborescence propre du paquet dans le véritable préfixe global, ce qui évite que npm superpose un nouveau paquet aux fichiers obsolètes de l’ancien. Si la commande d’installation échoue, OpenClaw réessaie une fois avec --omit=optional, ce qui aide les hôtes sur lesquels les dépendances natives facultatives ne peuvent pas être compilées.

Les commandes de mise à jour npm et de mise à jour des plugins gérées par OpenClaw désactivent également la quarantaine de la chaîne d’approvisionnement min-release-age de npm (ou l’ancienne clé de configuration before) pour le processus npm enfant. Cette politique offre une protection générale, mais une mise à jour explicite d’OpenClaw signifie « installer maintenant la version sélectionnée ».

pnpm add -g openclaw@latest

bun add -g openclaw@latest

Sujets avancés relatifs à l’installation npm

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

Mise à jour automatique

Désactivée par défaut. Activez-la dans ~/.openclaw/openclaw.json :

{  update: {    channel: "stable",    auto: {      enabled: true,      stableDelayHours: 6,      stableJitterHours: 12,      betaCheckIntervalHours: 1,    },  },}

Le Gateway consigne également une indication de mise à jour au démarrage (désactivez-la avec update.checkOnStart: false). Les sélections extended-stable enregistrées utilisent ce mécanisme d’indication en lecture seule et l’intervalle d’indication existant de 24 heures, mais ne déclenchent jamais d’installation automatique, de transfert, de redémarrage, de délai/variation stable ni d’interrogation bêta. Pour une rétrogradation ou une récupération après incident, définissez OPENCLAW_NO_AUTO_UPDATE=1 dans l’environnement du Gateway afin de bloquer les applications automatiques même lorsque update.auto.enabled est configuré. Les indications de mise à jour au démarrage peuvent toujours être exécutées, sauf si update.checkOnStart est également désactivé.

Les mises à jour du gestionnaire de paquets demandées par l’intermédiaire du plan de contrôle du Gateway actif (update.run) ne remplacent pas l’arborescence du paquet dans le processus Gateway en cours d’exécution. Sur les installations avec service géré, le Gateway lance un transfert détaché, s’arrête et laisse le parcours normal de la CLI openclaw update --yes --json arrêter le service, remplacer le paquet, actualiser les métadonnées du service, redémarrer, vérifier la version et l’accessibilité du Gateway, et restaurer si possible un LaunchAgent macOS installé mais non chargé. Si le Gateway ne peut pas effectuer ce transfert de manière sûre, update.run indique une commande d’interpréteur sûre au lieu d’exécuter le gestionnaire de paquets dans le processus.

La carte de mise à jour de la barre latérale de l’interface de contrôle lance ce même parcours update.run. Dans l’application macOS signée, la carte met d’abord à jour l’application avec Sparkle ; après la relance, l’application aligne son Gateway local géré sur la même version.

Après la mise à jour

openclaw doctor

openclaw gateway restart

openclaw health

Retour à une version antérieure

Épingler une version (npm)

npm i -g openclaw@<version>openclaw doctoropenclaw gateway restart

Épingler un commit (source)

git fetch origingit checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"pnpm install && pnpm buildopenclaw gateway restart

Pour revenir à la dernière version : git checkout main && git pull.

Si vous êtes bloqué

• Exécutez à nouveau openclaw doctor et lisez attentivement la sortie.
• Pour openclaw update --channel dev sur les copies de travail des sources, le programme de mise à jour initialise automatiquement pnpm si nécessaire. Si vous rencontrez une erreur d’initialisation de pnpm/corepack, installez pnpm manuellement (ou réactivez corepack), puis relancez la mise à jour.
• Consultez : Dépannage
• Demandez de l’aide sur Discord : https://discord.gg/clawd

Pages connexes

• Vue d’ensemble de l’installation : toutes les méthodes d’installation.
• Diagnostic : vérifications de l’état après les mises à jour.
• Migration : guides de migration entre versions majeures.