Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 dispose de son propre indicateur --verbose, mais cet indicateur ne fait pas partie de openclaw update. --channel beta privilégie beta, mais l’exécution revient à 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 paquet. Pour les plugins gérés, le repli du canal beta est un avertissement : la mise à jour du noyau peut quand même réussir pendant qu’un plugin utilise sa version par défaut/latest enregistrée, car aucune beta du plugin n’est disponible. 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. L’outil de mise à jour conserve votre état, votre configuration, vos identifiants et votre espace de travail dans ~/.openclaw ; il ne modifie que l’installation du code OpenClaw utilisée par le 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 compile et installe le CLI global 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’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 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 outil 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 verrouiller la récupération sur 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 depuis 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 empaqueté, puis remplace l’arborescence de paquets propre dans le préfixe global réel. 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 natives facultatives ne peuvent pas être compilées, tout en gardant 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

OpenClaw traite les installations globales empaquetées comme étant en lecture seule à l’exécution, même lorsque le répertoire global du paquet est accessible en écriture par l’utilisateur actuel. Les installations de paquets de plugins résident dans des racines npm/git appartenant à OpenClaw sous le répertoire de configuration utilisateur, et le démarrage du Gateway ne modifie pas l’arborescence du paquet OpenClaw.Certaines configurations npm Linux installent les paquets globaux dans des répertoires appartenant à root, comme /usr/lib/node_modules/openclaw. OpenClaw prend en charge cette disposition, car les commandes d’installation/mise à jour de plugins écrivent en dehors de ce répertoire global de paquet.
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 par doctor puissent conserver leurs changements :
ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp
Avant les mises à jour de paquets et les installations explicites de plugins, OpenClaw tente une vérification d’espace disque au mieux 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 par le gestionnaire de paquets et la vérification post-installation restent les sources d’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,
    },
  },
}
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.
devAucune application automatique. Utilisez openclaw update manuellement.
Le Gateway consigne également une indication 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 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 par gestionnaire de paquets demandées via le gestionnaire de plan de contrôle du Gateway en direct forcent un redémarrage de mise à jour non différé et sans délai de refroidissement 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 paquets déjà remplacée. La commande shell openclaw update reste la voie privilégiée 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

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

​
Restauration

​
Verrouiller une version (npm)

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

​
Verrouiller 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 de nouveau openclaw doctor et lisez attentivement la sortie.
  • Pour openclaw update --channel dev sur des checkouts source, l’outil de mise à jour initialise automatiquement pnpm si nécessaire. Si vous voyez une erreur d’initialisation pnpm/corepack, installez pnpm manuellement (ou réactivez corepack) et relancez la mise à jour.
  • Consultez : Dépannage
  • Demandez dans Discord : https://discord.gg/clawd

​
Connexe