Dépannage de la passerelle OpenClaw

Quand la page de triage rapide ne suffit pas, la documentation vous envoie vers le runbook profond de la passerelle. C’est un index plutôt qu’un mur de correctifs : une échelle de commandes, les signaux qu’une passerelle saine montre, et six pages par zone de symptôme avec des ancres stables. Sa section la plus utile est la courte liste de ce qui casse juste après une mise à niveau. Voici la carte.

L’échelle et les six pages

• Lancez les commandes de statut, de statut de passerelle, de suivi des journaux, de réparation et de sonde des canaux dans cet ordre ; sain signifie un runtime en marche, une sonde de connectivité correcte et une ligne de capacité, aucune alerte bloquante de configuration ou de service, et une sonde qui montre l’état de transport en direct par compte.
• Mises à jour et retours arrière couvre une passerelle laissée à terre ou désaccordée par une mise à jour, une rétrogradation ou une installation en cerveau divisé : après une mise à jour, le délai de publication du runtime de modèle préparé, le garde de configuration plus récente, corriger le chemin de recherche, réinstaller le service, retirer les enveloppes périmées et une discordance de protocole. Skills et fournisseurs de modèles couvre une racine de skill ignorée, l’erreur de limite de débit pour le contexte long avec ses correctifs, les réponses bloquées en amont, et un backend local compatible OpenAI qui passe les sondes mais échoue les runs.
• Réponses de l’agent et interface de contrôle couvre un run qui échoue avec une erreur de stockage, aucune réponse qui arrive, la connectivité du tableau de bord, les signatures de connexion et d’authentification avec une carte rapide des codes de détail et les étapes de défi, de signature et de nonce d’appareil. Service et processus couvre un service qui ne tourne pas ou ne reste pas debout, une passerelle macOS qui s’arrête en silence jusqu’à ce que le tableau de bord soit touché, une boucle de supervision avec des agents de lancement en double, et une sortie sous forte utilisation mémoire.
• Validation de configuration et sondes couvre une configuration invalide rejetée, ce qui s’est passé, inspecter et réparer, ses signatures courantes et ses options de correction, et les avertissements de sonde. Livraison des canaux et outils couvre un canal connecté sans messages qui circulent, la livraison planifiée et périodique, un nœud appairé dont l’outil échoue, les échecs de l’outil navigateur, les signatures de plugin et d’exécutable, les signatures de session de navigateur et les signatures d’élément, de capture et d’envoi ; chaque ancienne ancre se résout encore vers son nouvel emplacement.

La plupart des casses après mise à niveau sont une dérive de configuration ou des valeurs par défaut plus strictes désormais appliquées.

Si vous avez mis à niveau et que quelque chose a cassé

L’index garde trois vérifications en ligne. D’abord, le comportement d’authentification et de surcharge d’URL : lisez le mode de la passerelle, l’URL distante et le mode d’authentification, parce qu’avec le mode à distance la ligne de commande peut viser une passerelle distante alors que le service local va bien, et les appels avec URL explicite ne se rabattent pas sur les identifiants stockés ; une connexion échouée signifie une mauvaise cible d’URL et une signature non autorisée signifie un point de terminaison joignable avec la mauvaise authentification. Ensuite, les garde-fous de liaison sont plus stricts : les liaisons hors boucle locale exigent un chemin d’authentification valide, un jeton ou mot de passe partagé ou un proxy de confiance correctement configuré, et l’ancienne clé de jeton ne remplace pas la clé actuelle ; refuser de se lier sans authentification et une sonde en échec avec le runtime en marche sont les signatures. Enfin, l’état d’appairage et d’identité d’appareil : listez les appareils et les appairages de canal et cherchez des approbations en attente pour le tableau de bord ou les nœuds et après un changement de politique ou d’identité ; identité d’appareil requise et appairage requis sont les signatures. Si la configuration du service et le runtime sont encore en désaccord, réinstallez les métadonnées du service depuis le même profil et répertoire d’état puis redémarrez.

Lire les signaux

• Un runtime en marche avec une sonde de connectivité en échec est la combinaison la plus parlante : le processus est vivant mais la ligne de commande ne peut pas l’atteindre avec son URL et son authentification actuelles, le correctif est donc dans le mode, l’URL ou le jeton, pas dans le service.
• Une signature d’identité d’appareil requise après une mise à niveau n’est pas un bogue du client ; l’authentification d’appareil est désormais appliquée et le tableau de bord ou le nœud a besoin de son approbation en attente, que les listes d’appareils et d’appairage montrent.
• La sonde est par compte : un canal avec deux comptes peut montrer un transport qui fonctionne et un autre en échec, ce que la ligne de statut seule ne révèle pas.

Dépannage des canaux OpenClaw est le compagnon au niveau des canaux pour le cas où le transport se connecte mais le comportement est faux, et Le doctor d’OpenClaw explique la commande de réparation sur laquelle l’échelle s’appuie.

Pourquoi un index

Découper le runbook par zone de symptôme garde chaque page assez courte pour être lue pendant qu’un système est à terre, et les ancres préservées font que les liens venant d’anciens fils et tickets atterrissent encore sur la bonne section. L’ordre de l’échelle est délibéré aussi : il va du signal le plus large au plus étroit, et la réparation précède la sonde parce qu’elle corrige les mauvaises configurations que la sonde rapporterait sinon comme des échecs. L’appairage OpenClaw couvre les approbations que la troisième vérification cherche et La configuration OpenClaw les clés que les deux premières lisent.

Sur Diali

Sur Diali la configuration d’exécution est générée depuis le tableau de bord et remplacée à chaque version, ce qui supprime l’essentiel de la dérive que la section après mise à niveau décrit, et la même échelle tourne sur le runtime hébergé. OpenClaw hébergé sur Diali décrit l’assistant hébergé et La sécurité Diali la frontière autour de lui.

• Cinq commandes dans l’ordre ; runtime en marche plus sonde correcte, c’est sain.
• Six pages de symptômes ; chaque ancienne ancre se résout encore.
• Après une mise à niveau : mode et URL, liaison et authentification, appairage.