Le docteur d’OpenClaw

Le docteur est la commande sur laquelle se termine chaque page de dépannage de la documentation d’OpenClaw : l’outil de réparation et de migration qui corrige la configuration et l’état périmés, vérifie la santé et donne des étapes de réparation concrètes. Il est aussi plus prudent que son nom ne le suggère, avec un mode en lecture seule pour l’automatisation et un jeu d’options qui disent exactement jusqu’où il peut aller. Voici la commande, ses modes, la différence entre lint et réparation, et un tour de ce qu’il vérifie, regroupé comme la documentation le fait.

Les modes

• Simple : des vérifications guidées avec des invites, en appliquant les migrations sûres et les réparations confirmées, et un rapport de santé lisible.
• Oui, ou réparation : accepter les réparations hors service par défaut sans invite, en entrant en maintenance tout en préservant la définition du service de passerelle installé ; l’alias de réparation veut dire la même chose ; forcer ajoute les réparations agressives de configuration et d’état, et remplacer un lanceur est une commande d’installation distincte.
• Non interactif : aucune invite et seulement les migrations sûres, normalisation de la configuration et déplacements d’état sur disque, en sautant les redémarrages, les services et les actions de bac à sable ; avec la réparation, il applique aussi les réparations qui bloquent le démarrage comme la configuration de l’espace de travail, les magasins de sessions, les approbations d’exécution et les migrations du schéma d’audit, en vérifiant la propriété avant de toucher une base de données.
• Profond balaie les services système à la recherche d’installations de passerelle supplémentaires ; lint est le frère en lecture seule décrit ensuite.

Lecture seule : aucune invite, réparation, migration, redémarrage ni écriture d’état.

Lint contre réparation

Lint et réparation partagent le même registre de règles mais ne les sélectionnent ni ne les appliquent de la même façon. Lint lance des vérifications de santé structurées pour l’intégration continue et les contrôles préalables, avec une forme JSON, et par défaut le profil sûr et large : des vérifications statiques et locales, en sautant celles qui sont consultatives, sensibles à l’environnement, dépendantes d’un service en marche, d’inventaire ou de nettoyage historique, qu’une option tout rajoute et qu’une option seul restreint à une. La réparation n’utilise pas ce profil et n’accepte pas tout : elle suit le chemin de réparation ordonné, où les vérifications modernes peuvent proposer une réparation et où les zones plus anciennes gardent leur flux hérité, et certains constats de lint sont purement diagnostiques, si bien qu’un constat dans lint ne veut pas dire que la réparation changera cette zone.

Ce qu’il vérifie

• Santé, interface et mises à jour : une mise à jour préalable facultative pour les installations git, une reconstruction de fraîcheur du protocole de l’interface de contrôle, une vérification de santé avec une invite de redémarrage, des notes de compétences et d’extensions limitées aux problèmes, et les échecs de schéma des serveurs MCP signalés sans arrêter le reste.
• Configuration et migrations : normalisation des formes héritées, la table des clés héritées, les migrations de la voix, du navigateur, de Codex et des manifestes d’extensions, les avertissements de listes d’autorisation, les déplacements d’état sur disque, les migrations du magasin cron et des fichiers d’espace de travail, et le nettoyage de la configuration d’extensions périmée.
• État et intégrité : les verrous de session, la réparation des branches de transcription, les pierres tombales de sessions coincées, les permissions de l’état et de la configuration, et la santé de l’authentification des modèles avec rafraîchissement des jetons.
• Passerelle, services, superviseurs, sécurité et appairage : réparation de l’image de bac à sable, migration des services et détection d’installations supplémentaires, avertissements d’état des canaux, réparation des routes Codex, audit de la configuration du superviseur, nettoyage de l’environnement proxy, diagnostics de collision de ports, et avertissements pour les politiques de messages privés ouvertes.

Le fichier de configuration d’OpenClaw explique la validation stricte contre laquelle le docteur répare, et Mise à jour d’OpenClaw échouée le cas où une mise à jour échouée vous envoie ici.

Quand le lancer

Après une mise à niveau, après une modification à la main que la passerelle refuse, quand un service est installé mais ne tourne pas, et avant de demander de l’aide, parce que les gabarits de tickets de la documentation supposent que vous l’avez fait. Lisez d’abord le fichier de configuration si vous voulez relire les changements avant qu’ils soient écrits. Les commandes de terminal d’OpenClaw le liste parmi les commandes qui fonctionnent même quand la passerelle ne démarre pas.

Sur Diali

Sur Diali, le docteur tourne dans le cadre de chaque release que nous déployons, et ses constats sont à nous à traiter avant qu’une instance redémarre ; l’équivalent pour vous est la vue de santé du tableau de bord plutôt qu’un terminal. OpenClaw hébergé sur Diali est l’assistant.

• Lint lit ; la réparation écrit ; forcer écrit davantage.
• Non interactif veut dire migrations sûres seulement, sauf si la réparation est ajoutée.
• Six groupes de vérifications, des clés de configuration aux politiques de messages privés ouvertes.