OpenClaw sur Twitch
Le compte de bot, le générateur de jetons et le rafraîchissement, les listes d’identifiants plutôt que de noms, et la limite de 500 caractères
La prise en charge du chat Twitch dans OpenClaw passe par l’interface de chat de Twitch, qui est de l’IRC, via le client Twurple : OpenClaw se connecte comme compte de bot Twitch, rejoint un canal par compte configuré, et répond dans ce canal. Elle est livrée comme extension officielle plutôt que dans l’installation de base, et choisir Twitch pendant l’assistant de démarrage l’installe à la demande. Voici la configuration, la question des jetons qui piège tout le monde, la règle de contrôle d’accès sur laquelle la documentation est ferme, le filtrage par mention, l’usage multi-comptes, et les limites d’un chat en texte brut.
Configuration
- Installez l’extension, qui exige OpenClaw 2026.4.10 ou plus récent, et créez un compte Twitch dédié pour le bot ou utilisez un compte existant.
- Générez les identifiants avec le générateur de jetons Twitch : un jeton de bot avec les portées de lecture et d’écriture du chat, en copiant l’identifiant client et le jeton d’accès ; trouvez votre propre identifiant d’utilisateur Twitch avec un convertisseur de nom en identifiant.
- Placez le jeton dans la variable d’environnement du compte par défaut ou dans la configuration, la configuration l’emportant, puis lancez la passerelle ; la configuration minimale est le nom du bot, le jeton d’accès, l’identifiant client, le canal à rejoindre et une liste d’identifiants d’utilisateurs autorisés.
- Chaque canal rejoint correspond à une session de groupe isolée, les réponses reviennent toujours au canal d’origine du message, le nom d’utilisateur est celui qui s’authentifie tandis que le canal est la salle à rejoindre, et le préfixe oauth du jeton est facultatif.
Les noms d’utilisateur peuvent changer, ce qui permet l’usurpation. Les identifiants d’utilisateur sont permanents.
Jetons et durabilité
Les jetons du générateur ne peuvent pas être rafraîchis par OpenClaw et durent quelques heures, donc vous les regénérez à expiration ; pour un rafraîchissement automatique, vous créez votre propre application dans la console développeur de Twitch et ajoutez le secret client et un jeton de rafraîchissement, après quoi l’extension utilise un fournisseur d’authentification qui renouvelle avant l’expiration et journalise chaque rafraîchissement. Sans jeton de rafraîchissement, elle journalise que le rafraîchissement est désactivé, et sans secret client, elle retombe sur un jeton statique. Chaque message accepté est mis en file durablement avant l’envoi et dédoublonné par l’identifiant de message de Twitch, ce qui protège la fenêtre entre acceptation et envoi à travers un redémarrage ; mais Twitch ne rejoue pas un message après que le client l’a accepté, donc tout ce qui a été manqué avant l’admission durable est perdu, et une reconnexion ne le redemande pas.
Contrôle d’accès et comptes
- La liste d’autorisation est une liste stricte d’identifiants d’utilisateurs, et quand elle est définie la liste de rôles est ignorée ; laissez-la vide pour utiliser les rôles à la place, modérateur, propriétaire, VIP, abonné ou tous. L’avertissement en haut de la page est d’ajouter l’une ou l’autre, et la raison des identifiants plutôt que des noms est la citation ci-dessus.
- Les mentions sont exigées par défaut, donc les messages doivent nommer le bot ; mettez l’exigence de mention à false pour répondre à tous les messages autorisés du canal.
- Plusieurs canaux veulent dire plusieurs comptes, chacun avec son propre jeton d’accès puisque la variable d’environnement ne couvre que le compte par défaut, et une clé de compte par défaut choisit lequel l’est ; ne mélangez pas des identifiants de premier niveau avec la carte des comptes.
OpenClaw sur IRC est le protocole sous ce canal, avec la même réserve de durabilité, et OpenClaw sur Discord l’autre canal de communauté avec un filtrage par mention.
Dépannage et limites
Quand le bot ne répond pas, vérifiez que votre identifiant est dans la liste d’autorisation, ou autorisez temporairement tous les rôles pour tester, vérifiez le filtrage par mention, et vérifiez que le bot a rejoint le canal nommé dans la configuration ; sur des erreurs de connexion ou d’authentification, vérifiez la valeur du jeton et ses deux portées et, avec le rafraîchissement, le secret et le jeton de rafraîchissement. Les messages sont plafonnés à 500 caractères et découpés aux frontières de mots, le Markdown est retiré avec les sauts de ligne devenant des espaces, un texte devenu vide est enregistré comme volontairement non envoyé, et OpenClaw n’ajoute aucune limitation de débit propre parce que le client de chat gère celle de Twitch. Les secrets dans OpenClaw est là où un jeton a sa place plutôt que dans un fichier de configuration versionné, ce que la liste de sûreté répète : traiter les jetons comme des mots de passe, les rafraîchir, autoriser par identifiants, limiter les portées, et redémarrer la passerelle en cas de blocage après avoir vérifié que rien d’autre ne possède la session.
Sur Diali
Twitch 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 compte, un canal, une session isolée.
- Autorisez des identifiants d’utilisateurs, jamais des noms.
- Les jetons du générateur expirent ; votre propre application rafraîchit.
Arrêtez de lire, construisez le vôtre
Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.
