English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Maintenance

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.

bash
openclaw update

Pour changer de canal ou cibler une version spécifique :

bash
openclaw update --channel betaopenclaw update --channel devopenclaw update --tag mainopenclaw 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.

bash
# npm package install -> editable git checkoutopenclaw update --channel dev # git checkout -> npm package installopenclaw 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-runopenclaw 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 <version-or-dist-tag>

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

Read-only package tree

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.

Hardened systemd units

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
Disk-space preflight

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

Redémarrer le Gateway

bash
openclaw gateway restart

Vérifier

bash
openclaw health

Restauration

Verrouiller une version (npm)

bash
npm i -g openclaw@<version>openclaw doctoropenclaw gateway restart

Verrouiller un commit (source)

bash
git fetch origingit checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"pnpm install && pnpm buildopenclaw 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

Was this useful?