OpenClaw sur LINE

LINE se connecte à OpenClaw par la LINE Messaging API : l’extension tourne comme récepteur de webhook sur la passerelle et s’authentifie avec votre jeton d’accès de canal et votre secret de canal. C’est une extension officielle installée séparément, et la ligne d’état de la documentation est exacte sur la surface : messages directs, discussions de groupe, médias, lieux, messages Flex, messages gabarits et réponses rapides sont pris en charge ; les réactions et les fils ne le sont pas. Voici la configuration, le contrat de webhook qui rend la livraison durable, le contrôle d’accès, ce que LINE fait à un message, la règle de quota, et la liste de dépannage.

La configuration

• Installez l’extension, puis dans la console LINE Developers créez ou choisissez un Provider, ajoutez un canal Messaging API, copiez le jeton d’accès de canal et le secret de canal, et activez le webhook.
• L’URL du webhook est le chemin de webhook LINE de la passerelle en HTTPS, qui est obligatoire ; un chemin personnalisé est une clé de configuration. La passerelle répond à la requête de vérification signée de LINE, une liste d’événements vide.
• La vérification de signature est un HMAC sur le corps brut, donc OpenClaw applique une limite stricte de 64 Ko sur le corps avant authentification et un délai de lecture, et traite les événements depuis les octets bruts vérifiés, en ignorant ce qu’un intergiciel aurait réécrit.
• Les événements entrants signés entrent dans la file d’admission durable avant le 200 ; si la persistance durable échoue, la requête renvoie un 500 plutôt que d’acquitter un événement qui pourrait être perdu, et la livraison est au moins une fois à travers la frontière entre la file et l’agent, les événements de message étant dédoublonnés par identifiant de message LINE.

Un quota absent est inconnu, pas illimité.

Le contrat de livraison

Le 200 durable porte un en-tête d’acceptation pour qu’un proxy inverse le distingue d’un 200 générique. Les événements sont sérialisés par voie de conversation, groupe, salle ou utilisateur, avec un plafond de huit livraisons simultanées toutes voies confondues. Une livraison échouée est relancée avec un recul exponentiel à partir d’une seconde et part en lettre morte après la huitième tentative, LINE renonçant au plancher générique de 24 heures pour qu’un événement empoisonné ne bloque pas sa voie pendant une journée ; les charges illisibles, les livraisons qui ont déjà engagé des effets de bord, et les échecs d’authentification partent en lettre morte immédiatement. Un chien de garde de cinq minutes ne couvre que la fenêtre entre la réclamation et l’adoption, si bien qu’un long tour d’agent n’est jamais interrompu, un balayage de récupération reprend les réclamations dont le processus de passerelle a disparu, et une fenêtre de suppression des doublons garde les enregistrements terminés et échoués trente jours ou les 4 096 plus récents par compte. Le 500 n’aide que si LINE renvoie l’événement, ce qui exige la relivraison de webhook activée dans la console et reste au mieux un effort même alors.

Accès, messages, quotas

• Les messages directs sont en appairage par défaut : les expéditeurs inconnus reçoivent un code et sont ignorés jusqu’à approbation. Les politiques sont appairage, liste d’autorisation, ouvert ou désactivé pour les messages directs et liste d’autorisation, ouvert ou désactivé pour les groupes, avec des surcharges par groupe, et citer un des messages du bot compte comme s’adresser à lui. Les identifiants sont sensibles à la casse : U, C ou R suivi de 32 caractères hexadécimaux.
• Le texte est découpé à 5 000 caractères, le Markdown est retiré avec les blocs de code et les tableaux convertis en cartes Flex, le streaming est mis en tampon, l’animation de chargement ne tourne que dans les discussions en tête-à-tête, les téléchargements de médias sont plafonnés à dix mégaoctets par défaut, et plusieurs images choisies en une action arrivent comme un seul tour. Les réponses citées natives sont désactivées par défaut et limitées aux messages dont la passerelle en marche détient encore le jeton de citation, les 500 plus récents par compte.
• Le streaming par blocs est désactivé par défaut, et la documentation dit pourquoi : chaque bloc est un message séparé, et LINE compte les messages dans le quota mensuel du canal. Les envois refusés avec un 429 se lisent avec la sonde, dont le quota porte l’utilisé et la limite ; les messages ordinaires par jeton de réponse ne consomment pas l’allocation mensuelle, les envois poussés si.

L’appairage dans OpenClaw explique le flux d’approbation qu’utilise le réglage par défaut des messages directs, et OpenClaw sur Telegram est le canal que la documentation appelle le plus rapide à connecter si LINE n’est pas votre marché.

Messages riches et dépannage

Les blocs de boutons deviennent des contrôles Flex et les blocs de sélection des réponses rapides, au plus treize par message, et une question en discussion directe avec deux à quatre options devient des contrôles tactiles qui y répondent. Les images de cartes doivent être en HTTPS et tenir dans les limites LINE de 30 Ko par bulle et 50 Ko par carrousel ; les vidéos sortantes exigent une image d’aperçu, et les URL de médias doivent être des HTTPS publiques d’au plus 2 000 caractères, les cibles privées étant rejetées. Quand rien n’arrive, la sonde indique si le webhook est enregistré et activé, ce qu’OpenClaw ne peut pas régler pour vous ; quand des messages sont ignorés en silence, la liste des lettres mortes montre la raison, et un événement dont les effets de bord sont déjà engagés ne doit jamais être resoumis, parce que cela répète la réponse visible.

Sur Diali

LINE ne fait pas partie des canaux que Diali connecte aujourd’hui : ceux que nous faisons tourner sont WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS et la voix, et une instance autogérée est là où vit cette extension pour l’instant. Connecter votre premier canal en cinq minutes montre notre flux de connexion, OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit la frontière.

• Un récepteur de webhook avec une file durable devant l’agent.
• Appairage par défaut, et identifiants sensibles à la casse.
• Chaque bloc est un message, et les messages sont le quota.