Mise à jour

Gardez OpenClaw à jour.

Recommandé : `openclaw update`

Le moyen le plus rapide de mettre à jour. Il détecte votre type d’installation (npm ou git), récupère la dernière version, exécute npmopenclaw doctor et redémarre la passerelle.

openclaw update

Pour changer de canal ou cibler une version spécifique :

openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag main
openclaw update --dry-run   # preview without applying

openclaw update n’accepte pas --verbose. Pour le diagnostic de mise à jour, utilisez --dry-run pour prévisualiser les actions planifiées, --json pour des résultats structurés, ou openclaw update status --json pour inspecter l’état du canal et de la disponibilité. Le programme d’installation possède son propre indicateur --verbose, mais cet indicateur ne fait pas partie de openclaw update.

--channel beta préfère la version bêta, mais l’exécution revient à la version stable/la plus récente lorsque l’étiquette bêta est manquante ou plus ancienne que la dernière version stable. Utilisez --tag betanpm si vous souhaitez l’étiquette de distribution bêta npm brute pour une mise à jour ponctuelle du package.

Pour les plugins gérés, le repli sur le canal bêta est un avertissement : la mise à jour du cœur peut encore réussir pendant qu’un plugin utilise sa version par défaut/dernière enregistrée car aucune version bêta de plugin n’est disponible.

Voir Canaux de développement pour la sémantique des canaux.

Changer entre les installations npm et git

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

# npm package install -> editable git checkout
openclaw update --channel dev

# git checkout -> npm package install
openclaw update --channel stable

Exécutez d’abord avec --dry-run pour prévisualiser le changement exact de mode d’installation :

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

Le canal devCLI assure une extraction git, la construit et installe le CLI global à partir de cette extraction. Les canaux stable et beta utilisent des installations de packages. Si la passerelle est déjà installée, openclaw update actualise les métadonnées du service et la redémarre, sauf si vous passez --no-restart.

Pour les installations de package avec un service Gateway géré, Gatewayopenclaw update cible la racine du package utilisée par ce service. Si la commande shell openclaw provient d’une installation différente, le programme de mise à jour affiche les deux racines ainsi que le chemin Node du service géré. La mise à jour du package utilise le gestionnaire de packages propriétaire de la racine du service et vérifie le Node du service géré par rapport au moteur de publication cible avant de remplacer le package.

Alternative : réexécuter le programme d’installation

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

Ajoutez --no-onboard pour ignorer l’onboarding. Pour forcer un type d’installation spécifique via le programme d’installation, passez --install-method git --no-onboard ou --install-method npm --no-onboard.

Si openclaw updatenpmnpm échoue après la phase d’installation du package npm, réexécutez le programme d’installation. Ce dernier n’appelle pas l’ancien programme de mise à jour ; il exécute directement l’installation globale du package et peut récupérer une installation npm partiellement mise à jour.

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

Pour figer la récupération à une version ou à une balise de distribution spécifique, ajoutez --version :

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

Alternative : npm, pnpm ou bun manuel

npm i -g openclaw@latest

Privilégiez openclaw updateGatewayGatewayGatewayGateway pour les installations supervisées car il peut coordonner l’échange de package avec le service Gateway en cours d’exécution. Si vous effectuez une mise à jour manuelle sur une installation supervisée, arrêtez le Gateway géré avant que le gestionnaire de packages ne démarre. Les gestionnaires de packages remplacent les fichiers sur place, et un Gateway en cours d’exécution pourrait autrement tenter de charger des fichiers principaux ou des plugins alors que l’arborescence des packages est temporairement à moitié échangée. Redémarrez le Gateway une fois le gestionnaire de packages terminé afin que le service prenne en compte la nouvelle installation.

Pour une installation globale sur le système Linux détenue par root, si openclaw update échoue avec EACCES et que vous récupérez avec le npm du système, gardez le Gateway arrêté pendant le remplacement manuel du package. Utilisez les mêmes indicateurs de profil openclaw ou l’environnement que vous utilisez normalement pour ce Gateway. Remplacez /usr/bin/npm par le npm du système qui possède le préfixe global détenue par root sur votre hôte :

openclaw gateway stop
sudo /usr/bin/npm i -g openclaw@latest
openclaw gateway install --force
openclaw gateway restart

Vérifiez ensuite le service :

openclaw --version
curl -fsS http://127.0.0.1:18789/readyz
openclaw plugins list --json
openclaw gateway status --deep --json
openclaw doctor --lint --json

Lorsque openclaw update gère une installation globale npm, il installe d’abord la cible dans un préfixe npm temporaire, vérifie l’inventaire dist empaqueté, puis échange l’arborescence propre du package dans le véritable préfixe global. Cela évite à npm de superposer un nouveau package aux fichiers périmés de l’ancien package. Si la commande d’installation échoue, OpenClaw réessaie une fois avec --omit=optional. Cette nouvelle tentative aide les hôtes où les dépendances optionnelles natives ne peuvent pas être compilées, tout en gardant l’échec original visible si la solution de secours échoue également.

Les commandes de mise à jour OpenClaw-managed et plugin-update npm effacent également la mise en quarantaine npm min-release-age pour le processus npm enfant. npm peut signaler cette politique comme une coupure before dérivée ; les deux sont utiles pour les politiques générales de mise en quarantaine de la chaîne d’approvisionnement, mais une mise à jour explicite de OpenClaw signifie « installer la version OpenClaw sélectionnée maintenant ».

pnpm add -g openclaw@latest

bun add -g openclaw@latest

Sujets avancés d’installation npm

Arborescence de packages en lecture seule

OpenClaw traite les installations globales de packages comme étant en lecture seule lors de l’exécution, même lorsque le répertoire global des packages est accessible en écriture par l’utilisateur actuel. Les installations de packages de plugins résident dans les racines npm/git détenues par OpenClaw sous le répertoire de configuration utilisateur, et le démarrage de Gateway ne modifie pas l’arborescence des packages OpenClaw.

Certaines configurations npm Linux installent les packages globaux dans des répertoires détenus par root, tels que /usr/lib/node_modules/openclawOpenClaw. OpenClaw prend en charge cette disposition car les commandes d’installation/de mise à jour de plugins écrivent en dehors de ce répertoire global de packages.

Unités systemd renforcées

Donnez à OpenClaw un accès en écriture à ses racines de configuration/état afin que les installations explicites de plugins, les mises à jour de plugins et le nettoyage du docteur puissent persister leurs modifications :

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

Vérification préalable de l'espace disque

Avant les mises à jour de packages et les installations explicites de plugins, OpenClaw tente une vérification de l’espace disque de meilleure effort pour le volume cible. Un espace faible produit un avertissement avec le chemin vérifié, mais ne bloque pas la mise à jour car les quotas de système de fichiers, les instantanés et les volumes réseau peuvent changer après la vérification. L’installation réelle du gestionnaire de packages et la vérification post-installation restent faisant autorité.

Mise à jour automatique

La mise à jour automatique est désactivée par défaut. Activez-la dans ~/.openclaw/openclaw.json :

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

Canal	Comportement
`stable`	Attend `stableDelayHours`, puis applique avec une gigue déterministe sur `stableJitterHours` (déploiement étalé).
`beta`	Vérifie toutes les `betaCheckIntervalHours` (par défaut : toutes les heures) et applique immédiatement.
`dev`	Pas d’application automatique. Utilisez `openclaw update` manuellement.

Le Gateway enregistre également un indice de mise à jour au démarrage (désactivez avec update.checkOnStart: false). Pour une rétrogradation ou une récupération après incident, définissez OPENCLAW_NO_AUTO_UPDATE=1 dans l’environnement du Gateway pour bloquer les applications automatiques même lorsque update.auto.enabled est configuré. Les indices de mise à jour au démarrage peuvent toujours s’exécuter sauf si update.checkOnStart est également désactivé.

Les mises à jour du gestionnaire de paquets demandées via le gestionnaire de contrôle du Gateway en direct ne remplacent pas l’arborescence des paquets à l’intérieur du processus du Gateway en cours d’exécution. Sur les installations de service géré, le Gateway lance un transfert détaché, quitte, et laisse le chemin normal du 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 du Gateway et son accessibilité, et récupérer un LaunchAgent macOS installé mais non chargé lorsque cela est possible. Si le Gateway ne peut pas effectuer ce transfert en toute sécurité, update.run signale une commande shell sécurisée au lieu d’exécuter le gestionnaire de paquets en processus.

Après la mise à jour

Retour en arrière

Épingler une version (npm)

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

Épingler un commit (source)

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

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

Si vous êtes bloqué

Exécutez openclaw doctor à nouveau et lisez attentivement la sortie.
Pour openclaw update --channel dev sur les extraits de source, le programme de mise à jour amorce automatiquement pnpm si nécessaire. Si vous voyez une erreur d’amorçage pnpm/corepack, installez pnpm manuellement (ou réactivez corepack) et relancez la mise à jour.
Vérifier : Dépannage
Demander sur Discord : https://discord.gg/clawd

Connexes

Vue d’ensemble de l’installation : toutes les méthodes d’installation.
Docteur : vérifications de santé après les mises à jour.
Migration : guides de migration pour les versions majeures.