--- read_when: - Mise à jour d’OpenClaw - Quelque chose ne fonctionne plus après une mise à jour summary: Mettre à jour OpenClaw en toute sécurité (installation globale ou depuis les sources), avec une stratégie de restauration title: Mise à jour x-i18n: generated_at: "2026-05-11T20:42:44Z" model: gpt-5.5 provider: openai source_hash: cb1506ed87b1cf2e4928987c9dbfaff17d47b87f6c18239d694e0f55deb609f7 source_path: install/updating.md workflow: 16 --- 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. ```bash openclaw update ``` Pour changer de canal ou cibler une version spécifique : ```bash 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](/fr/install/development-channels) 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. ```bash # 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 : ```bash 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 ```bash 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. ```bash 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` : ```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version ``` ## Alternative : npm, pnpm ou bun manuels ```bash 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. ```bash pnpm add -g openclaw@latest ``` ```bash 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 : ```ini 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` : ```json5 { 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` | Aucune 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 ### Exécuter doctor ```bash openclaw doctor ``` Migre la configuration, audite les politiques de DM et vérifie l’état du Gateway. Détails : [Doctor](/fr/gateway/doctor) ### Redémarrer le Gateway ```bash openclaw gateway restart ``` ### Vérifier ```bash openclaw health ``` ## Restauration ### Verrouiller une version (npm) ```bash npm i -g openclaw@ openclaw doctor openclaw gateway restart ``` `npm view openclaw version` affiche la version actuellement publiée. ### Verrouiller un commit (source) ```bash 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](/fr/gateway/troubleshooting) - Demandez dans Discord : [https://discord.gg/clawd](https://discord.gg/clawd) ## Connexe - [Vue d’ensemble de l’installation](/fr/install) : toutes les méthodes d’installation. - [Doctor](/fr/gateway/doctor) : vérifications d’état après les mises à jour. - [Migration](/fr/install/migrating) : guides de migration de versions majeures.