OpenClaw sur QQ Bot

QQ Bot connecte OpenClaw à QQ par l’API officielle QQ Bot sur une passerelle WebSocket. Les conversations privées et les mentions de groupe sont les types de conversation principaux, avec des médias riches, images, voix, vidéo et fichiers, tandis que les canaux de guilde n’acceptent que le texte et les images par URL distante ; les réactions et les fils ne sont pris en charge nulle part. Il est livré comme extension officielle téléchargeable de Tencent Connect, et une installation ancienne sous le nom de paquet précédent est réécrite vers le nouveau à la mise à jour tandis que la configuration du canal reste où elle était. Voici la configuration, la durabilité, les secrets, le streaming, la politique d’accès, les groupes et leurs niveaux de commandes, la voix, les cibles, les commandes intégrées, le stockage, et le dépannage.

Configuration et durabilité

• Inscrivez-vous sur la plateforme ouverte QQ en scannant le code QR avec l’application du téléphone, créez un bot, et copiez l’AppID et l’AppSecret depuis sa page de réglages ; le secret n’y est pas stocké en clair, donc quitter la page sans l’enregistrer oblige à en régénérer un nouveau.
• Ajoutez le canal avec un jeton composé de l’AppID et de l’AppSecret joints par deux-points, ou lancez la commande d’ajout interactive, qui propose aussi une liaison par code QR avec l’application du téléphone liée au bot et conserve les identifiants renvoyés dans la portée de configuration du compte ; sondez ensuite l’état du canal et démarrez la passerelle si elle est hors ligne.
• Pour les événements de tour de la passerelle, OpenClaw conserve l’événement brut avant d’avancer la séquence de reprise enregistrée, si bien que les tours en attente ou relançables survivent à un redémarrage, restent sérialisés par conversation, et utilisent l’identifiant d’événement du fournisseur pour supprimer les doublons de file ; si l’admission durable échoue, le socket est fermé sans avancer la séquence pour que le chemin de reprise redemande l’événement non validé. La livraison reste au moins une fois à travers la frontière entre file et agent.
• Les secrets viennent de la configuration, en texte brut ou par chemin de fichier, ou de variables d’environnement du compte par défaut pour le seul compte de premier niveau ; l’option de fichier de jeton ne fixe que l’AppSecret, donc l’AppID doit déjà exister, et le paquet externe ne prend pas en charge les références de secrets structurées, donc une configuration qui en utilise une doit déplacer le secret vers la variable d’environnement ou un fichier avant la mise à niveau.

Chaque bot a son propre jeu d’OpenID d’utilisateurs. Un OpenID reçu par le bot A ne peut pas servir à envoyer des messages via le bot B.

Streaming, accès, groupes

Le streaming par blocs est activé par défaut en mode partiel et peut être désactivé par compte, et une option de transport natif diffuse les réponses de conversation privée par l’API officielle de messages en flux de QQ sans toucher aux cibles de groupe ou de canal ; les anciens réglages scalaires migrent par la correction du doctor, et une commande de streaming du bot bascule le même réglage depuis un message privé. L’accès est filtré par des listes d’autorisation pour les contextes privés et de groupe avec des politiques ouverte, liste ou désactivée qui valent liste par défaut dès qu’une entrée concrète existe, un réglage de visibilité du contexte décide si le texte cité que QQ fournit en contexte supplémentaire est gardé, filtré par la politique d’expéditeur, ou limité aux citations explicites, et plusieurs bots peuvent tourner sous une seule passerelle comme comptes nommés, chacun avec sa connexion WebSocket, son client d’API et son cache de jetons isolés, indexés par AppID et étiquetés dans les journaux. Les groupes s’adressent par OpenID plutôt que par nom d’affichage : une entrée joker fixe les défauts et une entrée concrète les surcharge pour un groupe, avec une mention obligatoire par défaut, un niveau de commandes, une option pour ignorer les mentions d’autrui, une limite d’historique de cinquante messages récents sans mention gardés comme contexte, des listes d’outils autorisés et refusés par groupe ou par expéditeur, un nom lisible et un prompt par groupe. Les niveaux de commandes sont tout, sécurité, qui garde visibles l’aide, btw et l’arrêt tandis que les commandes sensibles doivent passer en conversation privée, et strict, qui n’autorise que les contrôles de session de groupe tandis que l’arrêt continue de fonctionner ; la file entrante est par correspondant, avec un plafond plus grand pour les groupes, l’éviction des messages du bot avant ceux des humains quand elle est pleine, et les rafales de messages de groupe ordinaires fusionnées en un seul tour attribué.

Voix, cibles, commandes, stockage

• La reconnaissance et la synthèse vocales ont une configuration à deux niveaux avec repli par priorité, un fournisseur et un modèle propres à l’extension ou le premier modèle de média audio du cadre et la configuration TTS globale, avec des surcharges TTS par compte fusionnées en profondeur ; les requêtes de reconnaissance expirent après soixante secondes par défaut, la voix entrante atteint l’agent comme métadonnées audio tandis que les fichiers bruts restent hors des chemins de médias génériques, un marqueur audio en voix dans une réponse texte envoie un message vocal natif, et une politique de format audio règle les formats directs et le transcodage.
• Les cibles sont un OpenID privé, un OpenID de groupe ou un identifiant de canal de guilde sous le préfixe qqbot. Les commandes intégrées interceptées avant la file de l’IA comprennent ping, aide, moi pour afficher l’OpenID de l’expéditeur pour les listes, version, mise à niveau, approbation pour la configuration d’approbation d’exécution de commandes, export des journaux, nettoyage du stockage, streaming et la bascule d’activation des groupes ; celles filtrées par liste exigent une entrée explicite non joker, un joker permet de discuter mais pas ces commandes, et les clics sur les boutons natifs d’approbation d’exécution suivent la même liste sauf si des approbateurs dédiés sont configurés.
• Les médias entrants, sortants et de pont partagent une racine de charge gardée sous le répertoire d’état, les fichiers de cinq mébioctets ou plus utilisent les points d’envoi par morceaux de QQ tandis que les plus petits utilisent l’API en une fois, et si une mise à niveau à chaud interrompt la passerelle avant l’écriture complète de la configuration, l’extension restaure l’AppID et le secret connus depuis un instantané interne au démarrage suivant sans écraser un changement volontaire.

OpenClaw sur Feishu et Lark et OpenClaw sur WeChat sont les autres canaux centrés sur la Chine du catalogue, chacun avec sa propre extension et sa propre forme d’identifiants.

Sur Diali

QQ ne fait pas partie des canaux que Diali connecte aujourd’hui : WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS et voix. Connecter votre premier canal en cinq minutes explique comment ceux-là sont reliés, et La sécurité chez Diali la frontière qui s’applique à chacun.

Dépannage

Une passerelle qui ne démarre pas ou ne reçoit rien a généralement un AppID ou un secret faux ou un bot non activé sur la plateforme, et un identifiant manquant apparaît comme un message de non-configuration ; une configuration par fichier de jeton qui reste non configurée manque l’AppID ; les collisions de réponses de groupe en rafale sont traitées par les règles d’éviction et de fusion de la file ; les messages proactifs peuvent être bloqués par QQ quand l’utilisateur n’a pas interagi récemment ; et une voix non transcrite signifie une reconnaissance non configurée ou injoignable. OpenClaw hébergé sur Diali est l’assistant et Les extensions d’OpenClaw la surface par laquelle ce canal s’installe.

• AppID plus AppSecret, joints par deux-points.
• Des groupes par OpenID ; trois niveaux de commandes.
• Les OpenID d’un bot ne servent jamais à un autre.