Configurer Feishu dans OpenClaw

Feishu, et son jumeau international Lark, se connectent par un assistant qui peut même créer le bot pour vous en scannant un code QR. La partie intéressante de la documentation est ce qui se passe après la configuration : comment les événements entrants sont mis en file pour qu’un redémarrage ne perde rien, et pourquoi un webhook signé vieux de plus d’une heure est refusé. Voici le démarrage rapide, le modèle de durabilité, et la fenêtre de livraison.

Démarrage rapide

• Le canal exige OpenClaw 2026.5.29 ou plus récent, vérifié avec la commande de version et mis à niveau avec la commande de mise à jour.
• La commande de connexion des canaux pour le canal Feishu installe l’extension si elle manque et parcourt la configuration : la configuration manuelle colle un identifiant et un secret d’application depuis la plateforme ouverte Feishu ou la console développeur Lark, et la configuration par QR scanne un code dans l’application Feishu pour créer un bot automatiquement, en verrouillant les messages privés sur votre propre compte avec une politique en liste et votre identifiant ouvert.
• L’assistant demande aussi le domaine d’API, Feishu ou Lark, et la politique de groupe, et si l’application mobile Feishu domestique ne réagit pas au code QR, vous relancez la configuration et choisissez la configuration manuelle.
• Les changements de configuration suivent le rechargement à chaud, la sonde d’état vérifie que Feishu est prêt, et la passerelle est démarrée si elle est hors ligne.

Il n’existe aucune clé de configuration pour cette fenêtre ; elle est volontairement fixe.

Durabilité entrante

OpenClaw met durablement en file les enveloppes authentifiées de réception de message et d’ajout de commentaire avant la distribution à l’agent. En mode webhook, le 200 durable porte l’en-tête de livraison acceptée avec la valeur durable, tandis que les défis de vérification, les types d’événements non durables et les réponses d’erreur l’omettent, si bien qu’un proxy inverse peut exiger le marqueur pour distinguer une acceptation durable d’un 200 générique. Les événements en attente ou à réessayer survivent à un redémarrage de la passerelle, restent sérialisés par discussion ou document, et utilisent l’identifiant d’événement de Feishu pour supprimer les entrées de file en double tant que l’enregistrement de complétion actif ou conservé existe. Si un événement WebSocket ne peut pas être persisté après des tentatives bornées, OpenClaw ferme ce socket et force une nouvelle connexion authentifiée au lieu de continuer au-delà d’un tour non validé. Les autres types d’événements Feishu, dont les réactions et les invitations à des réunions, utilisent leurs chemins d’événements normaux et ne reçoivent pas la garantie de file durable.

La fenêtre de livraison des webhooks

• Feishu signe chaque livraison de webhook à l’envoi, si bien qu’un rappel signé capturé reste valablement signé pour toujours ; le mode webhook rejette donc tout rappel signé dont l’horodatage de requête est de plus d’une heure avant ou après l’horloge de l’hôte de la passerelle, avant même l’analyse du corps, comme défense contre les rejeux qui fonctionne avec la garde de rejeu par message et sa fenêtre de 24 heures pour qu’un rappel signé livré à nouveau ne puisse pas redéclencher la même action.
• Les conséquences pratiques sont une horloge d’hôte de passerelle synchronisée par NTP, puisqu’une dérive de plus d’une heure rejette les livraisons fraîches, et des relivraisons ordinaires qui portent des horodatages frais et ne sont pas affectées.
• Le mode WebSocket n’est pas affecté par la fenêtre, et il n’existe aucune clé de configuration pour elle ; elle est volontairement fixe.

OpenClaw sur Feishu est le billet du canal auquel cette configuration appartient, et Le contrôle d’accès Feishu d’OpenClaw ce qu’il faut décider ensuite sur qui peut atteindre le bot.

Durable avant d’être distribué

Mettre l’enveloppe en file avant que l’agent la voie est ce qui permet à un tour lent, un plantage ou une relivraison de ne laisser ni doublon ni trou, et l’en-tête d’acceptation permet au proxy en amont de vérifier que la file l’a prise. Configurer Telegram dans OpenClaw montre la même idée d’ingestion durable sur le webhook de Telegram, et Connecter votre premier canal en cinq minutes le parcours d’un premier canal.

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é.

• Manuel avec un identifiant d’application, ou QR qui crée le bot pour vous.
• Les événements de message et de commentaire sont mis en file durablement ; pas les réactions.
• Un webhook signé décalé de plus d’une heure est refusé.