Passer au contenu principal

​
Mise à jour

Gardez OpenClaw à jour.

​
Recommandé : openclaw update

La méthode la plus rapide pour effectuer la mise à jour. Elle détecte votre type d’installation (npm ou git), récupère la dernière version, exécute openclaw doctor et redémarre la passerelle. 
openclaw update
Pour changer de canal ou cibler une version spécifique : 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # aperçu sans appliquer
--channel beta privilégie la bêta, mais le runtime revient à stable/latest lorsque le tag bêta est manquant 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 du package. Voir Canaux de développement pour la sémantique des canaux.

​
Alternative : relancer l’installateur

curl -fsSL https://openclaw.ai/install.sh | bash
Ajoutez --no-onboard pour ignorer l’onboarding. Pour les installations depuis les sources, passez --install-method git --no-onboard.

​
Alternative : npm, pnpm ou bun manuels

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
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,
    },
  },
}
CanalComportement
stableAttend stableDelayHours, puis applique avec une gigue déterministe sur stableJitterHours (déploiement étalé).
betaVérifie toutes les betaCheckIntervalHours (par défaut : toutes les heures) et applique immédiatement.
devPas d’application automatique. Utilisez openclaw update manuellement.
La passerelle consigne également un conseil de mise à jour au démarrage (désactivez avec update.checkOnStart: false).

​
Après la mise à jour

1
Exécuter doctor
2
openclaw doctor
3
Migre la config, audite les politiques de DM et vérifie l’état de la passerelle. Détails : Doctor
4
Redémarrer la passerelle
5
openclaw gateway restart
6
Vérifier
7
openclaw health

​
Retour arrière

​
Épingler une version (npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
Astuce : npm view openclaw version affiche la version actuellement publiée.

​
Épingler un commit (sources)

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 si nécessaire. Si vous voyez une erreur d’amorçage pnpm/corepack, installez pnpm manuellement (ou réactivez corepack) puis relancez la mise à jour.
  • Vérifiez : Dépannage
  • Demandez dans Discord : https://discord.gg/clawd

​
Connexe