Mise à jour

Maintenez 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 openclaw doctor et redémarre le Gateway.

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 les diagnostics de mise à jour, utilisez --dry-run pour prévisualiser les actions prévues, --json pour obtenir 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 privilégie la bêta, mais l’environnement d’exécution se rabat sur stable/latest lorsque le tag bêta est absent ou plus ancien que la dernière version stable. Utilisez --tag beta si vous voulez le dist-tag npm bêta brut pour une mise à jour ponctuelle de paquet.

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

# Basculer entre les installations npm et git

Utilisez les canaux lorsque vous voulez 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 ne change que l’installation du code OpenClaw utilisée par la CLI et le Gateway.

# 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 dev garantit un checkout git, le construit et installe la CLI globale depuis ce checkout. Les canaux stable et beta utilisent des installations de paquets. Si le Gateway est déjà installé, openclaw update actualise les métadonnées du service et le redémarre, sauf si vous passez --no-restart.

# Alternative : relancer le programme d’installation

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

Ajoutez --no-onboard pour ignorer l’intégration initiale. Pour forcer un type d’installation précis via le programme d’installation, passez --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 le programme d’installation. Le programme d’installation n’appelle pas l’ancien programme de mise à jour ; il exécute directement l’installation du paquet global et peut récupérer une installation npm partiellement mise à jour.

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

Pour épingler la récupération à une version ou un dist-tag 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 manuels

npm i -g openclaw@latest

Préférez openclaw update pour les installations supervisées, car il peut coordonner le remplacement du paquet avec le service Gateway en cours d’exécution. Si vous mettez à jour manuellement pendant qu’un Gateway géré est en cours d’exécution, redémarrez le Gateway immédiatement après la fin du gestionnaire de paquets afin que l’ancien processus ne continue pas à servir des fichiers de paquet remplacés.

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 de paquet propre dans le véritable préfixe global. Cela évite que npm superpose un nouveau paquet sur des fichiers obsolètes de l’ancien paquet. 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 facultatives natives ne peuvent pas être compilées, tout en conservant l’échec initial visible si le repli échoue également.

pnpm add -g openclaw@latest

bun add -g openclaw@latest

# Sujets avancés d’installation npm

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

# Programme de mise à jour automatique

Le programme de mise à jour automatique est désactivé par défaut. Activez-le 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). 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 s’exécuter, sauf si update.checkOnStart est également désactivé.

Les mises à jour du gestionnaire de paquets demandées via le gestionnaire du plan de contrôle Gateway en direct forcent un redémarrage de mise à jour non différé et sans délai de récupération après le remplacement du paquet. Cela évite de laisser un ancien processus en mémoire assez longtemps pour charger paresseusement des fragments depuis une arborescence de paquet déjà remplacée. La commande shell openclaw update reste le chemin privilégié pour les installations supervisées, car elle peut arrêter et redémarrer le service autour de la mise à jour.

# Après la mise à jour

openclaw doctor

openclaw gateway restart

openclaw health

# Retour 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 à nouveau openclaw doctor et lisez attentivement la sortie.
• Pour openclaw update --channel dev sur des checkouts source, le programme de mise à jour amorce automatiquement pnpm lorsque 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érifiez : Dépannage
• Demandez sur Discord : https://discord.gg/clawd

# Connexe

• Aperçu de l’installation : toutes les méthodes d’installation.
• Doctor : vérifications d’état après les mises à jour.
• Migration : guides de migration des versions majeures.