Tu l'as clairement vu La passerelle est en cours d'exécution、La détection RPC est également verte, mais dans Telegram/SlackLes nouvelles n'arrivent tout simplement pas, l'agent est comme "déconnecté mais ne signale pas d'erreur". Cet article donne des conseils d'exploitation et de maintenancecouche de canalChemin de dépannage : utilisez d'abord sept listes pour supprimer l'illusion selon laquelle "la surface de contrôle est normale ≠ la surface de message est normale", puis utilisez-en uneSymptôme vs cause premièreLa table de recherche converge vers l'appariement,dmPolicy, mention de discussion de groupe et autorisations de Bot, enfin accordéesRunbook de récupération minimale en six étapes, et clairement lié au site pas prêt / démarrage bloqué、passerelle fermée (1000)、Installation multiplateforme La méthode de lecture par division du travail.
OpenClaw mettrePlan de contrôle, plan de session, plan de canal, backend de modèledémantelé à différents niveaux; il suffit de regarderopenclaw gateway statusIl est facile de mal diagnostiquer le problème car « le modèle est cassé ». Les sept éléments suivants sont utilisés pour l'auto-inspection avant l'examen afin d'empêcher l'équipe de rester inactive entre les trois types de journaux.
Traitez RPC OK comme lien de message OK :RPC multi-valide l'accessibilité du plan de contrôle natif ; Le routage DM/groupe dépend également du couplage, de l’accessibilité du webhook et des hits de stratégie.
Ignorer les modifications d'autorisation côté robot :Une fois que l'administrateur du canal a modifié les autorisations, que le robot est supprimé du groupe ou que le jeton est pivoté, la passerelle peut toujours s'afficher en cours d'exécution.
Le copier-coller dmPolicy est trop strict :Si la liste verte correspond par erreur à un ensemble vide ou à un ancien espace de travail, « sain mais tous rejetés » apparaîtra ; il devrait être assorti àRenforcement de la sécurité A lire en comparaison.
Le chat de groupe ne répond pas au contrôle de porte mentionné :Lorsque la stratégie de groupe exige que @Bot réponde, le « Je l'ai envoyé » verbal de l'utilisateur ne signifie pas que la condition de déclenchement est remplie.
Traitez les problèmes de chaîne d'outils MCP comme des problèmes de canal :Les symptômes de l'absence de réponse de l'outil sont similaires à ceux des messages qui n'arrivent pas ; ils devraient d’abord être exclus.Connectivité MCP Revenez à la chaîne.
Après la mise à niveau, affichez uniquement la configuration mais pas l'état d'appairage :L'authentification par défaut plus stricte de la nouvelle version peut rendre le couplage « semi-invalide » ; vous devez réexécuter le couplage conformément à la FAQ officielle.
Dérive multi-passerelle/multi-profil :systemd et CLI lisent différemmentopenclaw.jsonLorsque "Le vert que vous avez coché n'est pas l'instance connectée à l'utilisateur" apparaîtra.
La cause fondamentale commune de ces pièges est queaccessibilitéetDélivrabilitéConfus : le premier répond "si le processus et le port sont vivants", et le second répond "si ce DM est autorisé par la politique, s'il entre dans la session et s'il est consommé par le backend du modèle". Après les avoir inscrits dans le grand livre, utilisez le tableau suivant pour épingler les symptômes aux niveaux.
Si vous maintenez les deux pas prêt et fermé(1000)Il existe deux ensembles de runbooks, veuillez traiter cet article comme le troisième volume : lorsqu'il n'y a toujours pas de nouvelles après avoir exclu "Démarrage et session", revenez aux sondes et stratégies de canal.
et Renforcement de la sécurité de la passerelle Liaison : serrer dmPolicyL'entrée du message sera considérablement modifiée et la modification doit être accompagnée d'instructions Canary et Rollback.
Pas de solution miracle : vous devez d’abord répondreSur quelle couche le message est-il collé ?, puis décidez si vous souhaitez modifier la configuration ou les autorisations. Au cours de l'examen, notez clairement trois SLA : le délai d'arrivée des messages, l'explicabilité de l'échec et le temps d'annulation des modifications de politique.
| Ce que tu vois | Couche de cause profonde plus probable | Vérification préférée |
|---|---|---|
| Passerelle non prête / délai de démarrage expiré | Couche de démarrage et de vérification de l'état | lire pas prêt à résoudre les problèmes;Regardez le port, la mémoire, composez la séquence de démarrage |
| RPC est vert mais l'outil est anormal/fermé (1000) | Session, portée, jeton, modèle backend | lire articles fermés (1000);Alignement openclaw statusavec un médecin |
| La sonde des canaux a échoué ou le canal est déconnecté | Connexions de canal et informations d'identification | openclaw channels status --probe;Vérifiez l'accessibilité du jeton de bot et du webhook |
| La sonde est toute verte mais toujours pas d'arrivée | Politique : dmPolicy/gating de discussion de groupe/mention | contrôle SécuritéAvec l'expérience de reproduction minimale de la section 4 de cet article |
| Le message arrive mais l'agent ne répond pas | Quota côté modèle, CLI uniquement, délai d'expiration en aval | openclaw models status;et modèleRoutage lecture consécutive |
"Passerelle normale" indique uniquementsurface de contrôle vivante; Ce que tu veux acheter c'estDélivrabilité des messages: Les fonctionnalités de mise en relation, de stratégie et d'API de canal doivent figurer sur le même formulaire d'acceptation.
Si vous exécutez Gateway sur un VPS Linux, placez la lourde chaîne d'outils dansNœud exclusif Mac distant, veuillez écrire « Message Entry » et « Tool Execution » dans deux runbooks de tâches différents : le premier examine les canaux et les stratégies, et le second examine SSH et les niveaux de ressources.
et Liste des catégories OpenClawLien : les articles sur l'installation, Docker, systemd, l'observation et la sécurité doivent établir un contexte commun afin d'éviter que "chaque article reparte de zéro sur ce qu'est Gateway".
La séquence suivante met l'accent sur « d'abord un instantané global, puis une sonde de canal, puis une stratégie et une correspondance, et enfin une intervention chirurgicale majeure » : Identique aux « 60 premières secondes » de la FAQ officielle, mais complèteChat de groupe et dmPolicy Points aveugles courants.
Aperçu de l'exécution :openclaw status, confirmez que le système d'exploitation, les mises à jour, la passerelle sont accessibles et que les agents/sessions et les invites du fournisseur ne comportent aucun élément bloquant.
Exécuter la sonde de canal :openclaw channels status --probe, effacez d'abord les erreurs de déconnexion/d'authentification.
Appariement des colonnes :openclaw pairing list --channel telegram(Remplacer en fonction du canal réel), gérer en attente/expiré.
Stratégie de comparaison :Revoir dmPolicy, les règles de discussion en groupe et de mention sont cohérentes avec l'horaire de service ; sauvegarder avant de changeropenclaw.json。
Redémarrez la passerelle et vérifiez :openclaw gateway restartRépétez ensuite 01-02 ; si toujours anormal, réessayez.openclaw doctor。
Si l'échec persiste, collectez le paquet d'informations minimum :Version, fragments de configuration associés et 50 lignes de journaux avant et après (jeton de codage) pour faciliter le dépannage secondaire ou l'aide de la communauté.
openclaw status openclaw gateway status openclaw channels status --probe openclaw pairing list --channel telegram openclaw logs --follow openclaw doctor
indice:Si tu viens de changer gateway.bindOu chemin de génération inverse, veuillez vérifier en même tempsRenforcement de la sécuritéLa combinaison du bouclage et du jeton peut éviter que « la surface de contrôle semble accessible, mais le webhook est en réalité inaccessible ».
Si « les chaînes sont toutes vertes mais les messages n'arrivent toujours pas » apparaît après la mise à niveau, donnez la priorité aux soupçons.Dérive d'appariement avec serrage par défaut d'authentification: Réexécuter selon les notes de mise à jour officiellesopenclaw gateway install --forceAvec le médecin, au lieu de réécrire d'abord l'invite commerciale.
et fermé(1000)Lien d'article : s'il y a un cadre fermé dans le journal, vous devez d'abord revenir à la couche de session pour aligner la portée/le jeton, puis revenir à la stratégie de canal d'article, sinon la mauvaise couche sera modifiée à plusieurs reprises.
Le type d'accident de production le plus courant estLa politique est trop stricte + les documents de service ne sont pas synchronisés: Les journaux de la passerelle sont silencieux et les indicateurs sont silencieux, mais le côté commercial a l'impression que « l'agent fait semblant d'être mort ». Cette section donne une expérience de reproduction minimale : utilisez-la en premierchat privéVérifiez que le Bot est toujours disponible, puis revenez au chat de groupe pour libérer le contrôle des portes une par une.
Pour les chaînes telles que Telegram/Slack, vérifiez d'abord trois types de listes :Le bot est-il toujours dans le groupe ?、S'il faut exiger @mention、S'il faut limiter les sujets/threads; encore dmPolicyLa liste blanche est alignée sur le chemin de l'espace de travailSécuritéLe principe de l'exposition minimale.
Avis:Ne « libérez pas directement dmPolicy » pendant les périodes de pointe pour dépanner : ouvrez-le d'abordaudit en lecture seuleetcanal d'ombre(Petit groupe de comptes/Test Bot), confirmer que les règles sont respectées avant de converger sur la stratégie de production.
Si la passerelle s'exécute sur un VPS et que l'outil est exécuté surNœud exclusif Mac distant, veuillez consulter séparément la « stratégie de saisie des messages » et la « stratégie d'exécution SSH » : les erreurs dans la première feront croire aux utilisateurs que l'ensemble du site est en panne, tandis que les erreurs dans la seconde ne provoqueront que l'échec de certains outils.
Les éléments suivants sont destinés à l'alignement interne ; les seuils spécifiques dépendront de la taille de votre canal et des exigences de conformité.
dmPolicy/Les changements de classe de contrôle de groupe doivent être réservés au moinsUn retour d'appairage completetSauvegarde de restauration, pour éviter l'heure de pointe du soir, "changer une ligne pour être complètement silencieux".Un VPS local ou temporaire pur exécute Gateway, souvent dansVeille, dérive des ports, certificat et limitation du courant de la plateforme de messagerie instantanéeRépétez entre; et doit fonctionner de manière stablexcodebuild / Agent CLI / chaîne d'outils résidentel'équipe est plus adaptée pourPuissance de calcul et état du bureaumettre dedansEn ligne exclusif et à long termeSur le nœud Mac distant, laissez la passerelle sur la machine Linux pour vous concentrer sur la messagerie et l'orchestration. Par rapport à la création de vos propres machines dispersées ou au bricolage de macOS dans un environnement de virtualisation instable,Location Mac Mini Cloud de NodeMiniSSH fixe, fichiers de disque clairs et images de nœuds réplicables sont plus propices au découplage « exécution d'outils » de « entrée de message » ; lorsque vous avez besoin de comparer les spécifications et les prix, vous pouvez d'abord lireDescription du prix de location, combiné avec Centre d'aide Nœuds de planification.
Lors de la mise en œuvre, il est recommandé de lier ce runbook au « niveau de changement de canal » interne : les autorisations du robot, les stratégies de groupe, les versions de passerelle et la commutation back-end de modèle doivent utiliser différentes étendues d'approbation et Canary.
Le plan de contrôle multi-authentification RPC est accessible ; Le fait que les messages entrent dans la session dépend également du couplage des canaux, des autorisations du robot, de dmPolicy et du portail de discussion de groupe. Veuillez suivre la séquence de la section 3 de cet articlechannels status --probe et pairing list. Si vous avez besoin de suggestions côté nœud et réseau, vous pouvez les consulter.Centre d'aide。
L'article fermé (1000) se concentre sur la portée de la session, les jetons et les exceptions d'outils après la mise à niveau ; cet article se concentre sur le flux de messages de la couche canal. Si des images proches apparaissent fréquemment dans le journal, vous devez lire deux articles successivement : exclure d'abord les sessions et les backends de session, puis revenir aux appariements et aux stratégies. Les articles liés à OpenClaw peuvent être trouvés surBlog Filtrage OpenClaw Entrer.
Une topologie courante est que la passerelle reste dans le VPS Linux et que le Mac distant est utilisé comme nœud exclusif pour exécuter CLI/build et de lourdes dépendances ; la clé réside dans les contrats SSH et d'annuaire, plutôt que de lier la messagerie instantanée et la puissance de calcul à la même machine. Peut être comparé en premierDescription du prix de location et Accès coureur Capacité de planification du chapitre.