Passer au contenu principal

​
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 la Gateway. 
openclaw update
Pour changer de canal ou cibler une version spécifique : 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # preview without applying
--channel beta préfère beta, mais le runtime se rabat sur stable/latest lorsque le tag beta est absent ou plus ancien que la dernière version stable. Utilisez --tag beta si vous voulez le dist-tag npm beta 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 source, 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

​
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,
    },
  },
}
CanalComportement
stableAttend stableDelayHours, puis applique avec un jitter déterministe sur stableJitterHours (déploiement étalé).
betaVérifie toutes les betaCheckIntervalHours (par défaut : chaque heure) et applique immédiatement.
devPas d’application automatique. Utilisez openclaw update manuellement.
La Gateway journalise aussi 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 configuration, audite les politiques de messages privés et vérifie l’état de santé de la Gateway. Détails : Doctor
4
Redémarrer la Gateway
5
openclaw gateway restart
6
Vérifier
7
openclaw health

​
Rollback

​
Épingler une version (npm)

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

​
É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é

​
Lié