Dépanner Feishu dans OpenClaw

Les pannes Feishu se partagent entre le côté plateforme, une application non publiée, un événement non souscrit, une portée non accordée, et le côté passerelle, une horloge décalée d’une heure ou un secret périmé. La documentation liste les deux en courtes listes de contrôle. Les voici dans l’ordre : groupes silencieux, aucun événement, adhésion automatique aux réunions, webhooks rejetés, le flux QR, et un secret fuité.

Groupes silencieux et événements manquants

• Un bot qui ne répond pas dans les discussions de groupe exige quatre vérifications : que le bot est ajouté au groupe, que vous le mentionnez, puisqu’une mention est requise par défaut, que la politique de groupe n’est pas désactivée, et les journaux.
• Un bot qui ne reçoit aucun message en exige sept : l’application publiée et approuvée dans la plateforme ouverte Feishu ou la console développeur Lark, l’abonnement aux événements incluant l’événement de réception de message, l’événement d’invitation à une réunion ajouté pour l’adhésion automatique, la connexion WebSocket persistante sélectionnée, toutes les portées de permissions requises accordées, la passerelle en marche selon sa commande d’état, et les journaux.
• S’abonner à l’événement d’invitation à une réunion ne fait que livrer l’événement ; les adhésions automatiques sont désactivées par défaut et s’activent globalement par la clé d’adhésion automatique ou pour un seul compte en omettant l’interrupteur de premier niveau et en réglant la surcharge du compte.
• Les inviteurs passent encore par la politique normale de messages privés, la liste ou l’appairage, la session et le routage des réponses avant que l’agent reçoive un tour de jonction, et rejoindre exige aussi un outil de jonction VC Feishu disponible et configuré pour l’identité d’application avec la portée de jonction du bot de réunion, comme la compétence d’agent VC de la ligne de commande officielle, qui marque actuellement les actions de bot de réunion comme une bêta limitée où une erreur de non-inclusion ou le code d’erreur 20017 signifie que l’application ou le locataire n’a pas été activé pour la bêta et que les consignes d’accès anticipé s’appliquent avant le dépannage ordinaire des portées.

Les adhésions automatiques sont désactivées par défaut.

Webhooks rejetés

Un rappel de webhook rejeté avec un 401 de signature invalide a quatre vérifications. D’abord l’horloge de l’hôte de la passerelle, parce que le mode webhook rejette les rappels signés dont l’horodatage s’écarte de plus d’une heure de l’horloge du serveur dans un sens ou l’autre, donc la synchronisation NTP et une heure système correcte viennent en premier. Ensuite la clé de chiffrement configurée doit correspondre à la clé de chiffrement de l’application dans la console Feishu ou Lark. Puis le chemin et le port de l’URL du webhook doivent correspondre à la configuration de webhook du canal. Et enfin les journaux, suivis pour des échecs de signature répétés venant d’expéditeurs inattendus, qui désignent quelqu’un d’autre appelant le point de terminaison plutôt qu’un problème de configuration.

Configuration par QR et secret fuité

• Quand la configuration par QR ne réagit pas dans l’application mobile Feishu, relancez la commande de connexion du canal, choisissez la configuration manuelle, créez une application autonome dans la plateforme ouverte Feishu, copiez son identifiant et son secret d’application, et collez-les dans l’assistant.
• Un secret d’application fuité se fait tourner en le réinitialisant dans la console Feishu ou Lark et en mettant à jour la valeur dans la configuration.
• Vérifiez ensuite que le rechargement à chaud a appliqué les nouveaux identifiants avec la sonde d’état plutôt que de supposer qu’un redémarrage est nécessaire.

OpenClaw sur Feishu est le billet du canal auquel ces symptômes appartiennent, et Configurer Feishu dans OpenClaw l’assistant et la fenêtre de livraison auxquels la plupart remontent.

L’horloge avant la clé

L’ordre des vérifications de signature est délibéré : une horloge d’hôte décalée d’une heure rejette chaque rappel frais avant même que la clé soit comparée, donc c’est la première chose à écarter et celle qu’aucun changement de configuration ne corrige. Le contrôle d’accès Feishu d’OpenClaw couvre les politiques derrière un groupe silencieux, et Dépanner Slack dans OpenClaw la liste par symptôme pour Slack.

Sur Diali

Feishu et Lark ne font pas partie des canaux que Diali connecte aujourd’hui : WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS et voix. OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit la frontière qui s’applique à chaque canal connecté.

• Groupe silencieux : ajouté, mentionné, politique non désactivée, journaux.
• Un 401 signifie l’horloge, la clé ou le chemin, dans cet ordre.
• Faites tourner un secret fuité, puis sondez ; le rechargement à chaud l’applique.